# Autenticação

Todas as chamadas à API Dados Jah são autenticadas por **token de acesso**. Este guia explica como enviar o token, o que fazer em caso de erro e como manter sua conta segura.

## Token Bearer

A autenticação usa o padrão **Bearer Token**: o token é enviado no cabeçalho `Authorization` de cada requisição, precedido pela palavra `Bearer`.

```bash
curl --request GET \
  --url "https://api-dfe.dadosjah.com.br/v1/..." \
  --header "Authorization: Bearer SEU_TOKEN"
```

O token é obtido a partir de uma requisição /login. Cada chamada que você fizer precisa incluir esse cabeçalho — sem ele, a API não reconhece sua identidade.

## Qual rota /login usar?

Há duas rotas de autenticação na API e não é possível usar as credenciais ou o token de uma rota em outra.
 - /auth/system/login:
Rota para autenticar o sistema. Nesta rota deve ser utilizado as credenciais do sistema, que foram gerados no painel.
O token gerado por esta rota serve apenas nas rotas do grupo /system. É possível criar cadastros do "usuario", alterar dados do "usuario" ou do "sistema", mas não é possível por exemplo emitir uma nota ou gerar um pix;
- /auth/user/login:
Rota para autenticar o usuário (quem vai usar as rotas principais). Utilize as credenciais criadas no momento do cadastro na rota /user;

## Como tratar erro 401

O código `401 Unauthorized` indica que a autenticação falhou. As causas mais comuns são:

| Causa | Como resolver |
|---|---|
| Token ausente no cabeçalho | Inclua `Authorization: Bearer SEU_TOKEN` na requisição |
| Token incorreto ou expirado | Gere um novo token |
| Espaço em branco no token | Verifique se não há espaços ou quebras de linha ao copiar o token |

> **Importante:** se você receber `401`, sua requisição **não é processada** e, portanto, **não há consumo de créditos**. Corrija a autenticação e tente novamente.

## Segurança do token

O token dá acesso à sua conta e aos seus créditos. Trate-o como uma senha:

- **Nunca** exponha o token em código cliente (JavaScript no navegador, repositórios públicos, etc.).
- **Nunca** envie o token em URLs, logs ou ferramentas de terceiros.
- **Armazene** o token em local seguro no seu servidor (variáveis de ambiente ou cofre de segredos).
- Se suspeitar de vazamento, **gere um novo token imediatamente** no painel e invalide o anterior.

## Resumo do fluxo

1. Crie a conta e obtenha as credenciais no painel.
2. Faça a requisição /login e obtenha o token.
3. Envie o token no cabeçalho `Authorization: Bearer` em todas as chamadas.
4. Em caso de `401`, verifique o token e tente novamente.
