API de vérification SMS pour développeurs : premiers pas

Si vous testez le parcours d'inscription de votre application ou si vous automatisez la vérification, l'API vous permet de faire tout ce que fait le tableau de bord, sans avoir à l'ouvrir.

Avant de commencer

Récupérez votre clé sur la page API de votre tableau de bord. Ne versionnez pas la clé dans votre dépôt de code ; conservez-la dans une variable d'environnement.

Déroulement de base

1. Récupérez la liste des services et des pays.
2. Achetez un numéro.
3. Interrogez le statut à intervalles réguliers ou utilisez un webhook.
4. Validez l'activation lorsque le code arrive ; annulez-la s'il n'arrive pas.

Points à garder en tête

• En cas de nouvelle tentative, envoyez un en-tête Idempotency-Key. Si vous relancez avec la même clé après une erreur réseau, un second numéro ne sera pas acheté.
• Respectez la limite de débit ; ne raccourcissez pas inutilement l'intervalle d'interrogation.
• Gérez séparément les réponses « solde insuffisant » et « rupture de stock » dans votre code.

Si votre logiciel utilise le protocole compatible SMS-Activate, vous pouvez vous connecter via les points d'accès compatibles sans modifier votre code. Tous les détails figurent dans la documentation de l'API.