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é
Faites un premier crédit
L'accès à l'API s'ouvre avec le premier dépôt confirmé, à partir de 5 USD.
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.
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.
SMS Nitro en bref
| Facturation | Vous ne payez que si le code arrive. Si aucun SMS n'arrive avant l'expiration du numéro, le montant gelé revient intégralement sur votre solde, automatiquement. |
|---|---|
| Numéro réservé | Jusqu'à 20 minutes par activation. Location de 24 heures à 30 jours avec SMS illimités. |
| Paiement | Carte via Stripe (Visa, Mastercard, Amex, Apple Pay, Google Pay) ou crypto (USDC ou SOL sur Solana). Crédit minimum 5 USD. Les crédits par carte ont des frais de 10 % ; la crypto n'a pas de frais. |
| Abonnement | Aucun. Vous payez à la vérification et votre solde n'expire pas. |
| Pays | 180+ pays, dont la France, la Belgique, la Suisse, le Canada, les États-Unis, le Royaume-Uni, l'Allemagne et l'Indonésie. |
| Applications | 700+ applications et sites : WhatsApp, Telegram, Google, Instagram, TikTok, Discord, ChatGPT, PayPal, Tinder, Amazon, Vinted, Leboncoin et plus. |
| Développeurs | API REST et point d'accès compatible SMS-Activate. Clé disponible après votre premier crédit. Sans majoration. |
| Support | Tickets depuis le tableau de bord et e-mail, avec des réponses humaines. |
| Prix | À partir de 0,02 $US par code de vérification, selon l'application et le pays. |
Questions fréquentes
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.