# Autenticação

> Envie seu token com segurança em cada requisição.

Fonte: https://www.nextapi.com.br/docs/autenticacao

Envie o token no cabeçalho `Authorization` de cada requisição. Os exemplos desta documentação usam o formato Bearer:

```http
Authorization: Bearer SEU_TOKEN
Accept: application/json
```

A URL base da API é `https://api.nextapi.com.br`. Os endpoints documentados usam o prefixo `/v1`.

## Como obter e usar a chave

1. Entre no [painel da NextAPI](https://admin.nextapi.com.br/) e abra a área de chaves de API.
2. Gere uma chave para sua integração.
3. Configure o token no servidor e envie-o pelo cabeçalho nas chamadas à API.

## Onde guardar o token

Use variáveis de ambiente ou o gerenciador de segredos da sua infraestrutura. Não coloque o token em código do navegador, repositórios públicos ou URLs. Uma aplicação web deve chamar seu próprio backend, que faz a consulta autenticada à NextAPI.

## Falhas de autenticação

Nas consultas REST, a ausência do cabeçalho pode retornar HTTP `400` com código `1001`. Um token inválido retorna HTTP `401` com código `1002`. Verifique o status HTTP e, quando disponível, o campo `code` da resposta.

```json
{
  "status": "Erro",
  "code": 1002,
  "message": "Token de autenticação não informado ou inválido."
}
```

Não repita automaticamente uma chamada com a mesma credencial inválida. Corrija a configuração e tente novamente.