Entwickler-API
SMS-Verifizierung direkt aus deinem Code
Ein HTTPS-Aufruf gibt deinem Bot oder deiner Plattform eine echte Nummer für WhatsApp, Telegram und viele weitere Dienste. Lies den Code per Webhook oder Long Polling und zahle nur für Nummern, die einen Code erhalten.
- 2.281Dienste
- 200Länder
- Automatischerstattet, wenn kein Code ankommt
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": []
}
Gebaut für Automatisierung
Alles, was deine Integration braucht – mit demselben Bestand, derselben Buchhaltung und denselben Erstattungen wie die App.
-
Saubere REST-API
Vorhersehbares JSON, idempotente Käufe und klare Fehlergründe, auf die du reagieren kannst.
-
Signierte Webhooks
HMAC-signierte Ereignisse für jeden Code und jede Statusänderung, mit Wiederholungen über 24 Stunden.
-
Long Polling
Halte eine Anfrage bis zu 25 Sekunden offen und erhalte den Code, sobald er ankommt.
-
sms-activate-kompatibel
Richte deine bestehenden Tools auf eine neue Adresse. Aktionen und Antworten bleiben gleich.
-
Schlüssel unter deiner Kontrolle
Lese- oder Kaufschlüssel, IP-Freigabelisten, Tageslimits, Ablaufdatum und Rotation ohne Ausfallzeit.
-
Automatische Erstattungen
Kein Code, bevor die Nummer abläuft? Der Betrag geht direkt zurück auf dein Guthaben.
-
Nutzung und Anfrageprotokoll
Tägliche Anfragen, Ausgaben und Fehler pro Schlüssel, dazu ein filterbares Protokoll der letzten 7 Tage.
-
Mengenpreise
Dieselben Preise wie in der App, mit Rabatten, die automatisch mit deinem Monatsvolumen wachsen.
In vier Schritten live
Deine erste Nummer ist nur ein paar Aufrufe entfernt.
-
Konto erstellen
Registriere dich mit deiner E-Mail-Adresse und bestätige sie. App und Website teilen dasselbe Konto.
-
API-Schlüssel erstellen
Wähle den Zugriff, beschränke ihn auf deine Server und kopiere das Secret einmal.
-
Nummer kaufen
Sende Dienst und Land per POST. Du bekommst Nummer und Preis sofort.
-
Code empfangen
Warte per Long Polling oder Webhook und schließe die Aktivierung dann ab.
Preise, die mit dir sinken
Die API berechnet dieselben Preise wie die App. Dein Großhandelsrabatt wächst mit deinen Ausgaben der letzten 30 Tage auf allen Kanälen.
- Nie mehr als der Preis derselben Nummer in der App
- Nummern ohne Code werden automatisch erstattet
- Deine Stufe wird Minuten nach Erreichen aktualisiert
- Abgerechnet in USD vom selben Guthaben wie die App
Umstieg
Wechsle von sms-activate mit einer Zeile
Unser kompatibler Endpunkt spricht dasselbe Protokoll. Bots und Panels für sms-activate funktionieren, sobald du Basisadresse und Schlüssel änderst.
SMS-Activate wurde im Dezember 2025 eingestellt. Richte deine Tools auf SmsGrab aus und sie laufen weiter.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices und alle weiteren Standardaktionen
- Numerische Aktivierungs-IDs, Dienstcodes und Länder-IDs, die du schon nutzt
- Dieselben Schlüssel, Limits, Preise, Erstattungen und Webhooks wie bei der REST-API
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)
}
}
Echtzeit
Codes direkt auf deinen Server
Abonniere die Ereignisse, die dich interessieren, und wir liefern sie mit einer prüfbaren Signatur an deinen HTTPS-Endpunkt.
- Nummer gekauft
- Code empfangen
- Aktivierung abgeschlossen
- Aktivierung storniert
- Aktivierung abgelaufen
- Betrag erstattet
- Guthaben wird knapp
- Aufladung erstellt
- Aufladung wird bestätigt
- Aufladung gutgeschrieben
- Aufladung abgelaufen
- Aufladung in Prüfung
- Jede Zustellung ist mit HMAC-SHA256 und Zeitstempel signiert
- Nur öffentliche HTTPS-Endpunkte, geprüft vor jeder Zustellung
- Testzustellungen, 30 Tage Verlauf und erneute Zustellung per Klick
Fragen von Entwicklern
Was kostet die Entwickler-API?
Es gibt kein Abo. Jede Nummer kostet dasselbe wie in der App und wird aus demselben Guthaben bezahlt. Mengenstaffeln senken diesen Preis, wenn deine Ausgaben der letzten 30 Tage wachsen, und freigegebene Wiederverkäufer erhalten einen festen Rabatt. Nummern ohne Code werden automatisch erstattet.
Was passiert, wenn kein Code ankommt?
Eine Nummer ist bis zu der angezeigten Ablaufzeit gültig, meist 10 bis 20 Minuten. Kommt in dieser Zeit kein Code an oder stornierst du, solange sie noch wartet, wird der Betrag automatisch auf dein Guthaben erstattet.
Kann ich meine bestehende sms-activate-Integration nutzen?
Ja. Ersetze die Basisadresse durch unseren kompatiblen Endpunkt und verwende deinen SmsGrab-Schlüssel. Standardaktionen, Antworten und numerische IDs bleiben gleich.
Welche Ratenlimits gelten?
Standardmäßig kann jeder Schlüssel 600 Anfragen und 60 Käufe pro Minute ausführen, alle Schlüssel eines Kontos zusammen 3.000 Anfragen pro Minute, und bis zu 100 Nummern können gleichzeitig auf einen Code warten.
Wie halte ich meinen Schlüssel sicher?
Bewahre Schlüssel nur auf deinen Servern auf, gib jeder App einen eigenen Schlüssel, beschränke ihn auf deine Serveradressen und setze ein Tageslimit. Wurde ein Schlüssel womöglich öffentlich, rotiere oder widerrufe ihn in deinem Konto.
Weitere Antworten findest du im Hilfe-Center