Autenticação

A API Notaas usa API Keys para autenticar requisições. Todas as chamadas autenticadas devem incluir o header x-api-key com uma chave válida associada ao seu projeto.

Obtendo sua API Key

Acesse o Dashboard → API Keys
Clique em Nova Key
Selecione o projeto e defina o rate limit desejado
Copie a chave gerada — ela não será exibida novamente

Usando a API Key

Inclua a chave no header x-api-key em todas as requisições:

curl -X POST https://platform.notaas.com.br/api/v1/emitir \
  -H "Content-Type: application/json" \
  -H "x-api-key: ntaas_XXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -d '{ ... }'

Erros de Autenticação

Status	Motivo
401	Header `x-api-key` ausente ou inválido
403	Chave revogada ou sem permissão para o projeto
429	Rate limit excedido — verifique header `Retry-After`

⚠️ Segurança

Nunca exponha sua API Key em código frontend, repositórios públicos ou logs. Use variáveis de ambiente. Se uma chave for comprometida, revogue-a imediatamente no dashboard.