API développeurs
La vérification SMS depuis votre propre code
Un seul appel HTTPS donne à votre bot ou à votre plateforme un vrai numéro pour WhatsApp, Telegram et de nombreux autres services. Lisez le code par webhook ou long polling, et ne payez que les numéros qui en reçoivent un.
- 1 321services
- 145pays
- 0,10 $USprix minimum par numéro
- Autoremboursement sans code reçu
curl
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
-H "Authorization: Bearer $SMSGRAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"whatsapp","country":"indonesia"}'Python
activation = requests.post(
"https://smsgrab.com/api/dev/v1/activations",
headers={"Authorization": f"Bearer {key}"},
json={"service": "whatsapp", "country": "indonesia"},
).json()Node.js
const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
method: 'POST',
headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());PHP
$activation = json_decode((string) $client->post('activations', [
'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
])->getBody(), true);Go
order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation){
"id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
"compat_id": 100000123,
"status": "WAITING_SMS",
"service_id": "whatsapp",
"country_id": "indonesia",
"phone_number": "+6281234567890",
"price_minor": 18,
"currency": "USD",
"expires_at": "2026-09-27T10:25:00.000Z",
"sms": []
}Conçue pour l’automatisation
Tout ce dont votre intégration a besoin, avec le même stock, la même comptabilité et les mêmes remboursements que l’application.
-
Une API REST claire
Un JSON prévisible, des achats idempotents et des motifs d’erreur clairs sur lesquels agir.
-
Webhooks signés
Des événements signés HMAC pour chaque code et changement de statut, avec de nouvelles tentatives pendant 24 heures.
-
Long polling
Maintenez une requête jusqu’à 30 secondes et recevez le code dès son arrivée.
-
Compatible sms-activate
Pointez vos outils existants vers une nouvelle adresse. Les actions et les réponses restent les mêmes.
-
Des clés sous contrôle
Clés en lecture seule ou d’achat, listes d’IP autorisées, plafonds quotidiens, expiration et renouvellement sans interruption.
-
Remboursements automatiques
Pas de code avant l’expiration du numéro ? Le montant revient directement sur votre solde.
-
Utilisation et journal des requêtes
Requêtes, dépenses et erreurs quotidiennes par clé, plus un journal filtrable des 7 derniers jours.
-
Prix de volume
Des prix fondés sur le coût de gros qui baissent automatiquement quand votre volume mensuel augmente.
En ligne en quatre étapes
Votre premier numéro n’est qu’à quelques appels.
-
Créez un compte
Inscrivez-vous avec votre adresse e-mail et vérifiez-la. L’application et le site partagent le même compte.
-
Créez une clé API
Choisissez son accès, limitez-la à vos serveurs et copiez le secret une fois.
-
Achetez un numéro
Envoyez le service et le pays en POST. Vous obtenez aussitôt le numéro et son prix.
-
Recevez le code
Attendez par long polling ou webhook, puis terminez l’activation.
Des prix qui baissent avec votre croissance
Les prix développeur partent du coût de gros de chaque numéro, plus une majoration qui diminue avec votre volume sur 30 jours.
- Jamais plus cher que le même numéro dans l’application
- Au moins 0,10 $US par numéro
- Les numéros sans code sont remboursés automatiquement
- Votre palier est mis à jour quelques minutes après l’avoir atteint
- Facturé en USD sur le même solde que l’application
Majoration selon les dépenses développeur sur 30 jours
| Dépenses développeur sur 30 jours | Majoration sur le prix de gros | Prix d’exemple |
|---|---|---|
| Moins de 100,00 $US | +80 % | 0,18 $US 28 % de moins que dans l’application |
| À partir de 100,00 $US | +70 % | 0,17 $US 32 % de moins que dans l’application |
| À partir de 500,00 $US | +60 % | 0,16 $US 36 % de moins que dans l’application |
| À partir de 2 000,00 $US | +50 % | 0,15 $US 40 % de moins que dans l’application |
Exemple : une offre au coût de gros de 0,10 $US qui coûte 0,25 $US dans l’application.
Migration
Passez de sms-activate en une ligne
Notre point d’accès compatible parle le même protocole : les bots et panneaux conçus pour sms-activate fonctionnent dès que vous changez l’adresse de base et la clé.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices et toutes les autres actions standard
- Les identifiants d’activation numériques, codes de service et identifiants de pays que vous utilisez déjà
- Les mêmes clés, limites, prix, remboursements et webhooks que l’API REST
curl
BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"
curl -s "$BASE&action=getBalance"
curl -s "$BASE&action=getNumber&service=tg&country=6"
curl -s "$BASE&action=getStatus&id=100000123"
curl -s "$BASE&action=setStatus&id=100000123&status=6"Python
import os
import requests
BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]
def action(name: str, **params) -> str:
response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
response.raise_for_status()
return response.text
print(action("getBalance"))
answer = action("getNumber", service="tg", country=6)
if answer.startswith("ACCESS_NUMBER:"):
_, activation_id, number = answer.split(":")
print(activation_id, number)Temps réel
Les codes poussés vers votre serveur
Abonnez-vous aux événements qui vous intéressent et nous les livrons à votre point d’accès HTTPS avec une signature vérifiable.
- Numéro acheté
- Code reçu
- Activation terminée
- Activation annulée
- Activation expirée
- Montant remboursé
- Solde bas
- Chaque livraison est signée en HMAC-SHA256 avec un horodatage
- Uniquement des points d’accès HTTPS publics, vérifiés avant chaque livraison
- Livraisons de test, historique de 30 jours et relivraison en un clic
Questions des développeurs
Combien coûte l’API développeurs ?
Il n’y a pas d’abonnement. Chaque numéro coûte son prix de gros plus une majoration de 80 %, qui descend à 70 %, 60 % et 50 % lorsque vos dépenses développeur sur 30 jours dépassent 100, 500 et 2 000 USD. Un numéro ne coûte jamais moins de 0,10 USD ni plus que son prix dans l’application.
Que se passe-t-il si aucun code n’arrive ?
Un numéro est valable 20 minutes. Si aucun code n’arrive pendant ce temps, ou si vous annulez tant qu’il est en attente, le montant est remboursé automatiquement sur votre solde.
Puis-je utiliser mon intégration sms-activate existante ?
Oui. Remplacez l’adresse de base par notre point d’accès compatible et utilisez votre clé SmsGrab. Les actions standard, les réponses et les identifiants numériques restent les mêmes.
Quelles sont les limites de débit ?
Par défaut, chaque clé peut effectuer 600 requêtes et 60 achats par minute, toutes les clés d’un compte ensemble 3 000 requêtes par minute, et jusqu’à 100 numéros peuvent attendre un code en même temps.
Comment protéger ma clé ?
Gardez les clés uniquement sur vos serveurs, donnez à chaque application sa propre clé, limitez-la aux adresses de vos serveurs et fixez un plafond quotidien. Si une clé a pu fuiter, renouvelez-la ou révoquez-la depuis votre compte.
L’application et l’API partagent-elles le même solde ?
Oui. L’API utilise le solde de votre compte SmsGrab, et chaque achat et remboursement apparaît dans votre portefeuille comme les autres.
Retrouvez d’autres réponses dans le centre d’aide