Documentation de l’API SMS Nitro
Tout ce qu’il faut pour acheter un numéro temporaire, lire le code de vérification et clôturer la commande depuis votre propre code. JSON sur HTTPS, une clé d’API, les mêmes prix et la même règle de facturation que le tableau de bord.
Comment fonctionne l’API SMS Nitro ?
Vous envoyez POST /v1/orders avec l’application et le pays et recevez un numéro de téléphone. Vous interrogez ensuite GET /v1/orders/{id} toutes les 3 à 5 secondes jusqu’à ce que le SMS apparaisse dans messages, puis vous appelez finish. Si le SMS n’arrive pas, annulez : le montant réservé revient sur votre solde et vous ne payez que les codes reçus.
Démarrage rapide en quatre appels
Créez la clé
Faites une première recharge, ouvrez Tableau de bord > API et générez votre clé. Envoyez-la dans l’en-tête X-Api-Key.
Achetez un numéro
POST /v1/orders avec product et country. Le prix est réservé sur votre solde.
Lisez le code
Interrogez GET /v1/orders/{id} toutes les 3 à 5 secondes jusqu’à ce que messages contienne le SMS.
Clôturez la commande
POST finish si le code a fonctionné, ou cancel si rien n’est arrivé, pour être remboursé.
L’API en un coup d’œil
| Élément | Valeur |
|---|---|
| URL de base | https://smsnitro.com/api/v1 |
| Format | JSON sur HTTPS, UTF-8. Prix en chaîne décimale (USD), dates en ISO 8601 (UTC) |
| Authentification | En-tête X-Api-Key, ou Authorization: Bearer |
| Facturation | Prix réservé à l’achat, débité seulement à l’arrivée du SMS, remboursé sinon |
| Durée du numéro | Jusqu’à 20 minutes par activation |
| Limites | 500 achats par minute, 30 demandes de renvoi par minute |
| Spécification | OpenAPI 3.1 sur /developers/openapi.json |
Votre première requête
Vérifiez que la clé fonctionne en lisant votre solde. Une réponse 200 avec balance et frozen signifie que vous pouvez acheter des numéros. Frozen est le montant réservé par les commandes qui attendent encore un SMS.
curl https://smsnitro.com/api/v1/balance \
-H "X-Api-Key: $SMSNITRO_API_KEY"{
"balance": "12.50",
"frozen": "0.45",
"currency": "USD"
}Tous les articles
- AuthentificationS’authentifier sur l’API SMS Nitro : où générer la clé, les en-têtes X-Api-Key et Bearer, comment la remplacer et pourquoi elle ne doit jamais aller côté client.
- Référence des endpointsTous les endpoints de l’API REST v1 de SMS Nitro : solde, services, pays, commandes, finish, cancel, resend et ban, avec paramètres, requêtes curl et réponses JSON.
- Cycle de commande et facturationCe que signifie chaque statut de commande chez SMS Nitro, quand le solde est débité ou remboursé, la durée du numéro et quand annuler ou redemander un SMS.
- Erreurs et limites d’utilisationLes codes HTTP de l’API SMS Nitro (400, 401, 402, 404, 409, 429, 502), leur signification, les limites d’utilisation et une stratégie de nouvelles tentatives.
- Vérification par SMS en PythonRecevez des codes de vérification par SMS en Python avec l’API SMS Nitro et requests : achetez le numéro, attendez le code, terminez ou annulez. Script complet.
- Vérification par SMS en Node.jsRecevez des codes de vérification SMS en Node.js 18+ avec fetch et l’API SMS Nitro : achetez le numéro, attendez le code, terminez ou annulez. Types TypeScript.
- Vérification par SMS en PHPRecevez des codes de vérification par SMS en PHP 8 avec cURL et l’API SMS Nitro : achetez le numéro, attendez le code, terminez ou annulez. Script complet à copier.
Questions fréquentes
Existe-t-il un environnement de test ?
Non. Les appels utilisent le catalogue réel, mais rien n’est débité sans SMS : tester le parcours complet ne coûte que les codes réellement reçus.
Les prix de l’API diffèrent-ils du tableau de bord ?
Non. L’API utilise le même catalogue, les mêmes prix et le même solde que le site, sans supplément.
Où se trouve la spécification OpenAPI ?
Le document OpenAPI 3.1 des endpoints publics est disponible sur https://smsnitro.com/developers/openapi.json. Importez-le dans Postman, Insomnia ou un générateur de code.
Comment obtenir une clé d’API ?
Créez un compte, faites une première recharge et générez la clé dans Tableau de bord > API. Chaque compte a une seule clé active.
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