Sua primeira requisição
Antes de emitir um documento fiscal, faça uma chamada simples para confirmar três coisas:
- seu sistema alcança a API;
- a API Key está sendo enviada corretamente;
- sua aplicação consegue interpretar a resposta.
Uma consulta de leitura é a melhor escolha para esse primeiro teste.
Listar as empresas da conta
curl -s https://api.conota.dev/v1/empresas \
-H "X-API-Key: $CONOTA_API_KEY"
Se voltar uma lista (mesmo vazia), autenticação e conectividade estão corretas.
Consultar um CNPJ
curl -s https://api.conota.dev/v1/cnpj/60772432000142 \
-H "X-API-Key: $CONOTA_API_KEY"
Aceita com ou sem máscara, e aceita CNPJ alfanumérico.
Se preferir clicar antes de codar
Abra o Swagger UI, clique em Authorize, cole a chave e execute o endpoint. É a forma mais rápida de ver a resposta real antes de escrever código.
Depois que funcionar
Não copie a requisição do Swagger direto para produção. Implemente no backend e configure:
- timeout;
- logs sem expor segredos;
- tratamento por código HTTP;
- retentativa apenas para falhas que realmente podem ser repetidas;
- correlação entre a operação do seu sistema e a operação criada no Conota.
Nem toda falha pode ser repetida
Repetir uma consulta é inofensivo. Repetir uma emissão não é. Ver Referência externa e idempotência.