# Autenticação

Toda requisição à API REST leva sua chave num cabeçalho. Uma chave por conta, liberada depois da primeira recarga e revogável no painel a qualquer momento.

## Como autenticar na API da SMS Nitro?

Envie a chave no cabeçalho X-Api-Key (Authorization: Bearer <chave> também funciona) em toda requisição para https://smsnitro.com/api/v1. Chave ausente, errada ou revogada retorna 401 com o detalhe Invalid or revoked API key.

## Como gerar a chave

- O acesso à API é liberado depois da primeira recarga confirmada.
- Abra Painel > API e gere a chave. Ela aparece uma única vez, então guarde num cofre de segredos na hora.
- Cada conta tem uma chave ativa. Gerar uma nova revoga a anterior imediatamente.

## Como enviar a chave

Os dois formatos de cabeçalho valem em todos os endpoints. Escolha um e use sempre o mesmo.

| Cabeçalho | Exemplo |
|---|---|
| X-Api-Key | X-Api-Key: <sua chave> (recomendado) |
| Authorization | Authorization: Bearer <sua chave> |

**X-Api-Key**

```bash
curl https://smsnitro.com/api/v1/balance \
  -H "X-Api-Key: $SMSNITRO_API_KEY"
```

**Bearer**

```bash
curl https://smsnitro.com/api/v1/balance \
  -H "Authorization: Bearer $SMSNITRO_API_KEY"
```

## Como proteger a chave

A chave consegue gastar seu saldo, então trate como uma senha.

- Guarde numa variável de ambiente ou num gerenciador de segredos, nunca no código-fonte.
- Chame a API só do seu servidor. Nunca coloque a chave no navegador, num app de celular ou num programa de desktop.
- Não cole a chave em chamados, logs ou capturas de tela.
- Se vazar, gere uma nova no painel: a antiga para de funcionar na hora.

**Variável de ambiente**

```bash
# .env (never commit this file)
SMSNITRO_API_KEY=your-key-from-the-dashboard
```

## FAQ

**Posso ter mais de uma chave?** Não. Cada conta tem uma chave ativa; gerar outra substitui a atual.

**A chave expira?** Não. Ela vale até você gerar uma nova no painel.

Fonte: https://smsnitro.com/pt/desenvolvedores/autenticacao