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.
- 2 279services
- 200pays
- Autoremboursement sans code reçu
curl
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
-H "Authorization: Bearer $SMSGRAB_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-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}", "Idempotency-Key": str(uuid.uuid4())},
json={"service": "whatsapp", "country": "indonesia"},
timeout=30,
).json()
Node.js
const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
method: 'POST',
headers: {
Authorization: `Bearer ${key}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());
PHP
$activation = json_decode((string) $client->post('activations', [
'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
'headers' => ['Idempotency-Key' => bin2hex(random_bytes(16))],
])->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": 17,
"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’à 25 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
Les mêmes prix que l’application, avec des remises qui augmentent automatiquement avec votre volume mensuel.
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
L’API applique les mêmes prix que l’application. Votre remise de volume augmente avec vos dépenses des 30 derniers jours sur tous les canaux.
- Jamais plus cher que le même numéro dans l’application
- 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
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é.
SMS-Activate a fermé en décembre 2025. Pointez vos outils vers SmsGrab et ils continuent de fonctionner.
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 -w '\n' "$BASE&action=getBalance"
curl -s -w '\n' "$BASE&action=getNumber&service=tg&country=6&maxPrice=0.30"
curl -s -w '\n' "$BASE&action=getStatus&id=100000123"
curl -s -w '\n' "$BASE&action=setStatus&id=100000123&status=6"
Python
import os
import time
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, maxPrice="0.30")
if not answer.startswith("ACCESS_NUMBER:"):
raise SystemExit(answer)
_, activation_id, number = answer.split(":")
print("Number:", number)
while True:
status = action("getStatus", id=activation_id)
if status.startswith("STATUS_OK:"):
print("Code:", status.split(":", 1)[1])
action("setStatus", id=activation_id, status=6)
break
if status == "STATUS_CANCEL":
print("Cancelled or expired, the charge was refunded")
break
time.sleep(5)
Node.js
const BASE = 'https://smsgrab.com/api/stubs/handler_api.php';
async function action(name, params = {}) {
const url = new URL(BASE);
url.search = new URLSearchParams({ api_key: process.env.SMSGRAB_API_KEY, action: name, ...params }).toString();
const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
return response.text();
}
console.log(await action('getBalance'));
const answer = await action('getNumber', { service: 'tg', country: '6', maxPrice: '0.30' });
if (!answer.startsWith('ACCESS_NUMBER:')) {
throw new Error(answer);
}
const [, id, number] = answer.split(':');
console.log('Number:', number);
for (;;) {
const status = await action('getStatus', { id });
if (status.startsWith('STATUS_OK:')) {
console.log('Code:', status.slice('STATUS_OK:'.length));
await action('setStatus', { id, status: '6' });
break;
}
if (status === 'STATUS_CANCEL') {
console.log('Cancelled or expired, the charge was refunded');
break;
}
await new Promise((resolve) => setTimeout(resolve, 5000));
}
PHP
<?php
function smsgrab(string $action, array $params = []): string
{
$query = http_build_query(['api_key' => getenv('SMSGRAB_API_KEY'), 'action' => $action] + $params);
$answer = file_get_contents('https://smsgrab.com/api/stubs/handler_api.php?'.$query, false, stream_context_create(['http' => ['timeout' => 30]]));
if ($answer === false) {
throw new RuntimeException('The request failed');
}
return $answer;
}
echo smsgrab('getBalance').PHP_EOL;
$answer = smsgrab('getNumber', ['service' => 'tg', 'country' => 6, 'maxPrice' => '0.30']);
if (! str_starts_with($answer, 'ACCESS_NUMBER:')) {
exit($answer.PHP_EOL);
}
[, $id, $number] = explode(':', $answer);
echo 'Number: '.$number.PHP_EOL;
while (true) {
$status = smsgrab('getStatus', ['id' => $id]);
if (str_starts_with($status, 'STATUS_OK:')) {
echo 'Code: '.substr($status, strlen('STATUS_OK:')).PHP_EOL;
smsgrab('setStatus', ['id' => $id, 'status' => 6]);
break;
}
if ($status === 'STATUS_CANCEL') {
echo 'Cancelled or expired, the charge was refunded'.PHP_EOL;
break;
}
sleep(5);
}
Go
package main
import (
"fmt"
"io"
"net/http"
"net/url"
"os"
"strings"
"time"
)
const base = "https://smsgrab.com/api/stubs/handler_api.php"
var client = &http.Client{Timeout: 30 * time.Second}
func action(name string, params url.Values) (string, error) {
query := url.Values{"api_key": {os.Getenv("SMSGRAB_API_KEY")}, "action": {name}}
for key, values := range params {
query[key] = values
}
response, err := client.Get(base + "?" + query.Encode())
if err != nil {
return "", err
}
defer response.Body.Close()
body, err := io.ReadAll(io.LimitReader(response.Body, 1<<20))
if err != nil {
return "", err
}
if response.StatusCode != http.StatusOK {
return "", fmt.Errorf("http %d: %s", response.StatusCode, body)
}
return string(body), nil
}
func main() {
answer, err := action("getNumber", url.Values{"service": {"tg"}, "country": {"6"}, "maxPrice": {"0.30"}})
if err != nil {
panic(err)
}
if !strings.HasPrefix(answer, "ACCESS_NUMBER:") {
fmt.Println(answer)
return
}
parts := strings.Split(answer, ":")
id := parts[1]
fmt.Println("Number:", parts[2])
for {
status, err := action("getStatus", url.Values{"id": {id}})
if err != nil {
panic(err)
}
if code, ok := strings.CutPrefix(status, "STATUS_OK:"); ok {
fmt.Println("Code:", code)
if _, err := action("setStatus", url.Values{"id": {id}, "status": {"6"}}); err != nil {
panic(err)
}
return
}
if status == "STATUS_CANCEL" {
fmt.Println("Cancelled or expired, the charge was refunded")
return
}
time.Sleep(5 * time.Second)
}
}
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
- Recharge créée
- Recharge en confirmation
- Recharge créditée
- Recharge expirée
- Recharge en vérification
- 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 le même prix que dans l’application et se paie avec le même solde. Les paliers de volume baissent ce prix à mesure que vos dépenses sur 30 jours augmentent, et les revendeurs agréés obtiennent une remise fixe. Les numéros sans code sont remboursés automatiquement.
Que se passe-t-il si aucun code n’arrive ?
Un numéro reste valable jusqu’à l’heure d’expiration indiquée avec lui, en général 10 à 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.
Retrouvez d’autres réponses dans le centre d’aide