Autenticación
Cada petición a la API REST lleva tu clave en una cabecera. Una clave por cuenta, disponible tras la primera recarga y revocable desde el panel cuando quieras.
¿Cómo me autentico en la API de SMS Nitro?
Envía la clave en la cabecera X-Api-Key (Authorization: Bearer <clave> también funciona) en cada petición a https://smsnitro.com/api/v1. Una clave ausente, incorrecta o revocada devuelve 401 con el detalle Invalid or revoked API key.
Cómo generar la clave
- El acceso a la API se activa tras la primera recarga confirmada.
- Abre Panel > API y genera la clave. Solo se muestra una vez, así que guárdala enseguida en un gestor de secretos.
- Cada cuenta tiene una clave activa. Generar una nueva revoca la anterior al instante.
Cómo enviar la clave
Los dos formatos de cabecera valen en todos los endpoints. Elige uno y úsalo siempre.
| Cabecera | Ejemplo |
|---|---|
| X-Api-Key | X-Api-Key: <tu clave> (recomendado) |
| Authorization | Authorization: Bearer <tu clave> |
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"Cómo proteger la clave
La clave puede gastar tu saldo, así que trátala como una contraseña.
- Guárdala en una variable de entorno o en un gestor de secretos, nunca en el código fuente.
- Llama a la API solo desde tu servidor. Nunca la pongas en el navegador, en una app móvil ni en un programa de escritorio.
- No la pegues en tickets, registros ni capturas de pantalla.
- Si se filtra, genera una nueva en el panel: la anterior deja de funcionar en el acto.
# .env (never commit this file)
SMSNITRO_API_KEY=your-key-from-the-dashboardPreguntas frecuentes
¿Puedo tener varias claves?
No. Cada cuenta tiene una clave activa; generar otra sustituye la actual.
¿La clave caduca?
No. Sigue siendo válida hasta que generes una nueva en el panel.