> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notasx.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```http theme={null}
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.

> [!WARNING]
>
> 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`:

```json theme={null}
{"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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.