# Votre clé API

La clé API relie vos scripts, bots ou outils internes à SMS Nitro pour acheter des numéros et lire les codes sans passer par le tableau de bord. Elle peut dépenser votre solde exactement comme vous : traitez-la comme un mot de passe.

## Où trouver la clé API de SMS Nitro ?

Dans la section API du tableau de bord, débloquée après votre premier crédit confirmé. Vous y générez la clé, affichée une seule fois : copiez-la et rangez-la en lieu sûr. Chaque compte a une seule clé active, et en générer une nouvelle révoque immédiatement la précédente. La même clé sert pour l'API REST et pour le point d'accès compatible SMS-Activate.

## Obtenir la clé

1. **Faites un premier crédit** L'accès à l'API s'ouvre avec le premier dépôt confirmé, à partir de 5 USD.
2. **Ouvrez la section API** Vous y voyez si une clé est active, son préfixe, sa date de création et sa dernière utilisation.
3. **Générez et copiez** La clé complète n'apparaît qu'une fois. Conservez-la dans un gestionnaire de mots de passe ou une variable d'environnement du serveur.

## Où utiliser la clé

- API REST : base https://smsnitro.com/api/v1, avec la clé dans l'en-tête X-Api-Key ou en Authorization: Bearer. Réponses en JSON.
- Point d'accès compatible SMS-Activate : https://smsnitro.com/api/stubs/handler_api.php, avec la clé dans le paramètre api_key. Pratique pour les outils qui parlent déjà ce protocole.
- Pour savoir si le code est arrivé, interrogez le statut de la commande à intervalle régulier : nous n'envoyons pas de notification vers votre serveur.
- Des SDK Python et Node ainsi qu'une collection Postman permettent de tester les appels.
- Les achats par API suivent les règles du tableau de bord : prix retenu, débit seulement si le code arrive, montant rendu sans SMS.

## Réponses du point d'accès compatible

- NO_KEY ou BAD_KEY : clé absente, mal copiée ou révoquée après la génération d'une nouvelle.
- NO_BALANCE : solde insuffisant pour l'achat. Créditez puis réessayez.
- WRONG_COUNTRY ou BAD_SERVICE : pays ou service non valide pour cette demande.
- STATUS_WAIT_CODE et STATUS_OK : SMS encore attendu, ou SMS livré avec le code.
- EARLY_CANCEL_DENIED : annulation demandée trop tôt ; réessayez quelques minutes plus tard.

## Protéger la clé

- Ne la publiez jamais dans un dépôt de code, une capture d'écran ou une discussion : qui la détient peut utiliser votre solde.
- Gardez-la côté serveur, dans une variable d'environnement ou un coffre de secrets, jamais dans une application mobile ou un site public.
- En cas de fuite supposée, ou si une personne qui la connaissait quitte l'équipe, générez-en une nouvelle : l'ancienne cesse de fonctionner aussitôt.
- Changer le mot de passe du compte ne change pas la clé API : les deux sont indépendants.

## Limites et gros volumes

Des limites de requêtes protègent le service. Interroger le statut d'une commande toutes les quelques secondes est normal ; balayer le catalogue en boucle ne l'est pas. Pour un volume important, contactez le support avant de démarrer.

## FAQ

**Pourquoi je ne peux pas générer de clé API ?** Parce que l'accès à l'API s'ouvre après le premier dépôt confirmé. Créditez votre solde et le bouton de génération apparaîtra dans la section API. En crypto, attendez la confirmation de la transaction.

**J'ai perdu ma clé API, pouvez-vous me la renvoyer ?** Non. Nous ne conservons qu'une version chiffrée et la clé complète ne s'affiche qu'une fois. Générez-en une nouvelle depuis le tableau de bord : l'ancienne est révoquée immédiatement, pensez à la remplacer dans vos outils.

**L'API est-elle compatible avec SMS-Activate ?** Oui. Le point d'accès handler_api.php reprend ce protocole, donc beaucoup d'outils fonctionnent en changeant seulement l'adresse et la clé. Pour une nouvelle intégration, l'API REST en JSON est plus confortable.

**Puis-je avoir plusieurs clés API sur un compte ?** Non. Chaque compte a une seule clé active. En générer une nouvelle révoque la précédente, ce qui simplifie la rotation et évite les anciennes clés oubliées.

Source: https://smsnitro.com/fr/aide/cle-api