API pour recevoir des SMS de vérification
L'API pour recevoir des SMS de SMS Nitro met dans votre code les mêmes opérations que le tableau de bord : même catalogue, mêmes prix, même règle de facturation. Si vous venez d'un script écrit pour SMS-Activate, vous changez seulement l'adresse et la clé.
Comment recevoir un code de vérification avec l'API de SMS Nitro ?
Après votre premier crédit confirmé, vous générez la clé dans le tableau de bord. Un POST /api/v1/orders avec le service et le pays vous renvoie le numéro ; vous consultez ensuite la commande toutes les quelques secondes jusqu'à l'apparition du SMS, puis vous la clôturez avec finish. Sans SMS en 20 minutes, le montant retenu revient seul sur le solde.
Les appels de la REST v1
Tous les appels partent de https://smsnitro.com/api/v1 et répondent en JSON avec les codes HTTP habituels. La clé se transmet dans l'en-tête X-Api-Key ; Authorization: Bearer suivi de la clé fonctionne aussi.
- GET /balance : solde disponible et montant retenu par les commandes en cours, en dollars.
- GET /services : liste des services avec leur prix ; GET /services/{service}/countries donne les pays de ce service et le prix de chacun.
- POST /orders achète un numéro ; GET /orders et GET /orders/{id} servent au suivi du statut et à la lecture du texte du SMS.
- Actions sur une commande : finish la clôture, cancel l'annule avant l'arrivée d'un SMS et vous rend le montant, resend demande un autre code sur le même numéro sans frais, ban signale un numéro déjà utilisé sur ce service.
Une alternative à l'API SMS-Activate
Beaucoup de bots et de logiciels d'inscription ne parlent que le protocole SMS-Activate. Pour eux, il existe https://smsnitro.com/api/stubs/handler_api.php : il accepte GET ou POST avec les paramètres api_key et action, et répond toujours avec un HTTP 200. Le client doit donc lire le corps de la réponse pour connaître le résultat.
Les actions prises en charge sont getBalance, getNumber, getStatus, setStatus, getPrices, getNumbersStatus, getServicesList et getCountries, avec des montants en dollars. Une différence à connaître : country=0, ou l'absence du paramètre, désigne les États-Unis, et non la Russie comme dans le protocole d'origine.
SDK Python et Node, collection Postman
Les paquets officiels s'installent avec pip install smsnitro (Python) et npm i smsnitro (Node.js et TypeScript). Les deux incluent une fonction qui attend le code avec un délai maximum et lèvent une exception explicite si la commande se ferme sans SMS. La collection Postman regroupe tous les appels et s'importe aussi dans Insomnia ou Bruno.
Prix, facturation et limites
- Les prix par l'API sont ceux du tableau de bord, sans majoration.
- Le prix est figé au moment de l'achat et débité seulement si le SMS arrive.
- Sur certains numéros, l'annulation devient possible environ 2 minutes après l'achat.
- L'achat et le renvoi de SMS sont limités en nombre de requêtes par minute et par adresse IP. Les SDK consultent le statut toutes les 4 secondes : un rythme raisonnable aussi pour votre code.
- Chaque compte a une seule clé active : en générer une autre dans le tableau de bord révoque immédiatement la précédente.
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
Faut-il une offre spéciale pour utiliser l'API de vérification SMS ?
Non. Tout compte qui a au moins un crédit confirmé peut générer sa clé dans le tableau de bord et appeler l'API, aux mêmes prix que sur le site. Il n'y a ni abonnement ni formule développeur à souscrire.
Mes scripts SMS-Activate fonctionnent-ils avec SMS Nitro ?
Oui, par handler_api.php : vous changez l'adresse de base et la clé. Vérifiez seulement les codes de pays, puisque le 0 correspond ici aux États-Unis. Le reste de la logique, getNumber puis getStatus et setStatus, reste le même.
L'API me prévient-elle quand le SMS arrive ?
Non, il n'y a pas de notification automatique. Vous faites le suivi du statut de la commande (GET /orders/{id} ou getStatus) toutes les quelques secondes jusqu'à ce que le texte apparaisse. Les SDK le font pour vous avec leur fonction d'attente.
Existe-t-il un environnement de test ?
Ce n'est pas nécessaire : faites un petit crédit, testez sur des services peu chers et rappelez-vous qu'un numéro qui ne reçoit pas de SMS n'est jamais facturé. Une intégration complète se valide ainsi pour quelques centimes.
Peut-on avoir plusieurs clés API sur un même compte ?
Non. Il n'y a qu'une clé active ; en générer une nouvelle révoque l'ancienne, donc mettez à jour tout de suite chaque script qui l'utilise. Si plusieurs machines appellent l'API, elles partagent la même clé.
Pages associées
Recevez votre code de vérification maintenant
Créditez à partir de 5 USD, choisissez l'application et le pays, lisez le SMS dans votre navigateur. Débité uniquement quand le code arrive.
Obtenir un numéro+1 (415) 555-0132