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> |
curl https://smsnitro.com/api/v1/balance \
-H "X-Api-Key: $SMSNITRO_API_KEY"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.
# .env (never commit this file)
SMSNITRO_API_KEY=your-key-from-the-dashboardPerguntas frequentes
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.