Choisir une langue

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)
201 Created
{
  "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.

  1. 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.

  2. Créez une clé API

    Choisissez son accès, limitez-la à vos serveurs et copiez le secret une fois.

  3. Achetez un numéro

    Envoyez le service et le pays en POST. Vous obtenez aussitôt le numéro et son prix.

  4. 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

Remise selon les dépenses sur 30 jours

Les paliers de volume ne sont pas actifs pour le moment. Vous payez les mêmes prix que dans l’application, et les revendeurs agréés obtiennent leur remise fixe.

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
Référence de compatibilité

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
Guide des webhooks
600requêtes par minute et par clé
60achats par minute et par clé
100numéros en attente simultanément
25secondes de long polling
  • 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.

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

Prêt à automatiser la vérification ?

Créez une clé dans votre compte et faites votre premier appel en quelques minutes.