Headers Obrigatórios
Para garantir rastreabilidade, autenticação e tolerância a falhas, os endpoints fiscais utilizam cabeçalhos específicos.
Tabela de Headers
| Header | Tipo | Obrigatório | Descrição |
|---|---|---|---|
x-api-key | string | Sim | Chave de autenticação gerada no portal da API (fylee_test_... ou fylee_live_...). |
Content-Type | string | Sim (em POST/PUT) | Deve ser sempre application/json (ou multipart/form-data para envio de certificado A1). |
Accept | string | Opcional | application/json ou application/pdf (ao baixar DANFE diretamente). |
Idempotency-Key | string | Recomendado | Chave exclusiva da transação para proteção contra reenvios e cobrança em duplicidade. |
Exemplo de Requisição com Headers Completos
http
POST /v1/invoices/nfe HTTP/1.1
Host: api.fylee.com.br
x-api-key: fylee_live_a89f9d78e7b9e7c8
Content-Type: application/json
Accept: application/json
Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d