Autenticação

Chave de API para integrações; sessão para o painel. As duas representam a mesma Conta.

Toda requisição leva o header:

Authorization: Bearer <credencial>

A credencial pode ser:

Credencial	Formato	Para quê
Chave de API	nx_ + 43 caracteres	Integrações (seu ERP, backend, scripts).
Sessão do painel	JWT do login	O painel do NotasX.

As duas agem como a mesma Conta, sobre todos os Prestadores vinculados a ela. Não há permissões por Prestador: quem tem uma Chave da Conta acessa todos os Prestadores da Conta.

​

Chaves de API

• O valor da chave aparece uma única vez, na criação. O NotasX guarda só um hash; não há como recuperá-lo.
• O prefixo (os 10 primeiros caracteres) aparece na listagem, para você saber qual chave é qual.
• Revogue com DELETE /v1/chaves-api/{id}: o efeito é imediato e não tem volta.
• Crie uma chave por sistema. Assim você revoga uma sem derrubar as outras.

Uma Chave de API pode criar outras Chaves. Trate-a como uma senha: nunca a coloque em código de front-end, em repositório ou em log.

​

Respostas de autenticação

Credencial ausente, inválida, revogada ou expirada recebe 401:

{"erro": {"codigo": "nao_autenticado", "mensagem": "Credencial ausente, inválida ou revogada."}}

Recursos de Prestadores que não são da sua Conta respondem 404, como se não existissem.