API pour développeurs
Achetez des numéros depuis votre propre logiciel avec des clés API, des remises de volume, des webhooks signés et un point d’accès compatible sms-activate.
5 guides · 4 réponses rapides
Guides
-
Démarrage rapide de l'API pour développeurs Achetez des numéros et lisez les codes depuis votre propre logiciel. Créez une clé, consultez les prix, achetez un numéro, attendez le SMS et terminez, étape par étape.
-
Clés API et sécurité Portées, listes d'adresses IP autorisées, plafonds de dépense quotidiens, expiration, rotation sans interruption et que faire si une clé fuite.
-
Prix de volume et paliers L’API vend aux mêmes prix que l’application, moins votre remise de volume : un palier selon vos dépenses sur 30 jours, ou une remise revendeur fixe.
-
Webhooks Recevez en temps réel les événements d'activation sur votre serveur, vérifiez l'en-tête SmsGrab-Signature et comprenez les nouvelles tentatives, les envois de test et la désactivation automatique.
-
Le point d'accès compatible sms-activate Continuez à utiliser les bots et panneaux conçus pour le protocole sms-activate en changeant une seule URL. Actions prises en charge, formats d'identifiants et différences à connaître.
Réponses rapides
Combien coûte l'API pour développeurs ?
Il n’y a pas d’abonnement : vous payez par numéro, avec votre solde habituel. Chaque numéro coûte le même prix que dans l’application, moins votre remise de volume. Les paliers de volume baissent le prix dès que vos dépenses nettes des 30 derniers jours, tous canaux confondus, dépassent un seuil, et les revendeurs agréés obtiennent une remise fixe ; c’est toujours la plus avantageuse des deux qui s’applique. Les numéros sans code sont remboursés comme d’habitude. Voir Prix de volume et paliers.
Combien de requêtes puis-je envoyer à l'API ?
Par défaut, chaque clé peut envoyer 600 requêtes et effectuer 60 achats par minute, et toutes les clés d'un compte réunies 3 000 requêtes par minute. Jusqu'à 100 numéros peuvent attendre un code en même temps par compte, et jusqu'à 20 requêtes en attente (?wait=) peuvent être ouvertes par clé. Au-delà d'une limite, vous recevez 429 RATE_LIMITED avec un en-tête Retry-After ; chaque réponse porte aussi des en-têtes RateLimit-*. Voir Démarrage rapide de l'API pour développeurs.
Ma clé API a fuité. Que dois-je faire ?
Agissez tout de suite : révoquez la clé dans Compte > Développeurs, ou faites-la tourner avec une période de transition de 0 heure. La révocation est immédiate et ne demande pas de mot de passe. Vérifiez ensuite le journal des requêtes de la clé et votre Portefeuille pour repérer toute activité inconnue, puis créez une nouvelle clé avec une liste d'IP autorisées et un plafond de dépense quotidien. Gardez les clés uniquement sur des serveurs, jamais dans des applications ou des pages Web. Voir Clés API et sécurité.
Les outils conçus pour sms-activate fonctionnent-ils avec SmsGrab ?
Dans la plupart des cas, oui. Pointez l'outil vers https://smsgrab.com/api/stubs/handler_api.php et utilisez votre clé API SmsGrab comme api_key. Les actions standard sont prises en charge, de getBalance et getNumber à setStatus et getStatus. Les montants sont en dollars américains à votre prix, remise de volume comprise, pas en roubles, et la location n'est pas disponible. Voir Le point d'accès compatible sms-activate.
Autres thèmes
Besoin d’aide supplémentaire ?
Écrivez-nous. Nous répondons à chaque message, généralement en quelques heures.
Ou écrivez-nous à support@smsgrab.com