Authentification
Chaque requête à l’API REST transporte votre clé dans un en-tête. Une clé par compte, disponible après la première recharge et révocable à tout moment depuis le tableau de bord.
Comment s’authentifier sur l’API SMS Nitro ?
Envoyez la clé dans l’en-tête X-Api-Key (Authorization: Bearer <clé> fonctionne aussi) à chaque requête vers https://smsnitro.com/api/v1. Une clé absente, erronée ou révoquée renvoie 401 avec le détail Invalid or revoked API key.
Générer la clé
- L’accès à l’API s’ouvre après la première recharge confirmée.
- Ouvrez Tableau de bord > API et générez la clé. Elle ne s’affiche qu’une fois : enregistrez-la tout de suite dans un coffre de secrets.
- Chaque compte a une clé active. En générer une nouvelle révoque immédiatement la précédente.
Envoyer la clé
Les deux formats d’en-tête sont acceptés sur tous les endpoints. Choisissez-en un et gardez-le partout.
| En-tête | Exemple |
|---|---|
| X-Api-Key | X-Api-Key: <votre clé> (recommandé) |
| Authorization | Authorization: Bearer <votre clé> |
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"Protéger la clé
La clé peut dépenser votre solde : traitez-la comme un mot de passe.
- Gardez-la dans une variable d’environnement ou un gestionnaire de secrets, jamais dans le code source.
- Appelez l’API uniquement depuis votre serveur. Ne la placez jamais dans un navigateur, une application mobile ou un logiciel de bureau.
- Ne la collez pas dans des tickets, des journaux ou des captures d’écran.
- En cas de fuite, générez-en une nouvelle depuis le tableau de bord : l’ancienne cesse aussitôt de fonctionner.
# .env (never commit this file)
SMSNITRO_API_KEY=your-key-from-the-dashboardQuestions fréquentes
Puis-je avoir plusieurs clés ?
Non. Chaque compte a une clé active ; en générer une autre remplace l’actuelle.
La clé expire-t-elle ?
Non. Elle reste valable jusqu’à ce que vous en génériez une nouvelle depuis le tableau de bord.