SmsGrab

Thema

Inloggen Nederlands

Kies een taal

Ontwikkelaars-API

Sms-verificatie vanuit je eigen code

Eén HTTPS-aanroep geeft je bot of platform een echt nummer voor WhatsApp, Telegram en nog veel meer diensten. Lees de code via een webhook of long polling en betaal alleen voor nummers die er een krijgen.

API-sleutel aanvragen Documentatie lezen
  • 1.321diensten
  • 145landen
  • US$ 0,10minimumprijs per nummer
  • Automatischterugbetaald als er geen code komt

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)
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": 18,
  "currency": "USD",
  "expires_at": "2026-09-27T10:25:00.000Z",
  "sms": []
}

Gebouwd voor automatisering

Alles wat je integratie nodig heeft, met dezelfde voorraad, boekhouding en terugbetalingen als de app.

  • Een heldere REST-API

    Voorspelbare JSON, idempotente aankopen en duidelijke foutredenen waarop je kunt reageren.

  • Ondertekende webhooks

    Met HMAC ondertekende gebeurtenissen voor elke code en statuswijziging, met herhalingen tot 24 uur.

  • Long polling

    Houd een verzoek tot 30 seconden open en krijg de code zodra hij binnenkomt.

  • Compatibel met sms-activate

    Wijs je bestaande tools naar één nieuw adres. Acties en antwoorden blijven hetzelfde.

  • Sleutels onder jouw controle

    Lees- of koopsleutels, IP-toelatingslijsten, daglimieten, vervaldatum en vervangen zonder onderbreking.

  • Automatische terugbetaling

    Geen code voordat het nummer verloopt? Het bedrag gaat direct terug naar je saldo.

  • Gebruik en verzoeklogboek

    Dagelijkse verzoeken, uitgaven en fouten per sleutel, plus een filterbaar logboek van de laatste 7 dagen.

  • Volumeprijzen

    Prijzen op basis van de groothandelsprijs die vanzelf dalen naarmate je maandvolume groeit.

Live in vier stappen

Je eerste nummer is maar een paar aanroepen verwijderd.

  1. Maak een account

    Registreer je met je e-mailadres en verifieer het. De app en de website gebruiken hetzelfde account.

  2. Maak een API-sleutel

    Kies de toegang, beperk hem tot je servers en kopieer het geheim één keer.

  3. Koop een nummer

    POST de dienst en het land. Je krijgt meteen het nummer en de prijs.

  4. Ontvang de code

    Wacht met long polling of een webhook en rond daarna de activering af.

Snelstart openen

Prijzen die dalen terwijl je groeit

Ontwikkelaarsprijzen beginnen bij de groothandelsprijs van elk nummer plus een opslag die kleiner wordt met je volume over 30 dagen.

  • Nooit duurder dan hetzelfde nummer in de app
  • Minimaal US$ 0,10 per nummer
  • Nummers zonder code worden automatisch terugbetaald
  • Je niveau wordt binnen enkele minuten na het bereiken bijgewerkt
  • Afgerekend in USD vanaf hetzelfde saldo als de app

Opslag per ontwikkelaarsuitgaven over 30 dagen

Ontwikkelaarsuitgaven over 30 dagen Opslag op de groothandelsprijs Voorbeeldprijs
Onder US$ 100,00 +80% US$ 0,18 28% goedkoper dan in de app
Vanaf US$ 100,00 +70% US$ 0,17 32% goedkoper dan in de app
Vanaf US$ 500,00 +60% US$ 0,16 36% goedkoper dan in de app
Vanaf US$ 2.000,00 +50% US$ 0,15 40% goedkoper dan in de app

Voorbeeld: een aanbod met een groothandelsprijs van US$ 0,10 dat in de app US$ 0,25 kost.

API-sleutel aanvragen

Overstappen

Stap over van sms-activate met één regel

Ons compatibele endpoint spreekt hetzelfde protocol, dus bots en panelen die voor sms-activate zijn gebouwd, werken zodra je het basisadres en de sleutel wijzigt.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices en alle andere standaardacties
  • De numerieke activerings-ID’s, dienstcodes en land-ID’s die je al gebruikt
  • Dezelfde sleutels, limieten, prijzen, terugbetalingen en webhooks als de REST-API
Compatibiliteitsreferentie

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)

Realtime

Codes direct naar je server

Abonneer je op de gebeurtenissen die je belangrijk vindt en we leveren ze aan je HTTPS-endpoint met een handtekening die je kunt controleren.

  • Nummer gekocht
  • Code ontvangen
  • Activering afgerond
  • Activering geannuleerd
  • Activering verlopen
  • Bedrag terugbetaald
  • Saldo raakt op
Webhook-handleiding
600verzoeken per minuut per sleutel
60aankopen per minuut per sleutel
100tegelijk wachtende nummers
30seconden long polling
  • Elke levering is ondertekend met HMAC-SHA256 en een tijdstempel
  • Alleen openbare HTTPS-endpoints, gecontroleerd voor elke levering
  • Testleveringen, 30 dagen geschiedenis en opnieuw afleveren met één klik

Vragen van ontwikkelaars

Wat kost de ontwikkelaars-API?

Er is geen abonnement. Elk nummer kost de groothandelsprijs plus 80% opslag, die daalt naar 70%, 60% en 50% zodra je ontwikkelaarsuitgaven over 30 dagen boven 100, 500 en 2.000 USD komen. Een nummer kost nooit minder dan 0,10 USD en nooit meer dan in de app.

Wat gebeurt er als er geen code komt?

Een nummer is 20 minuten geldig. Komt er in die tijd geen code, of annuleer je terwijl het nog wacht, dan wordt het bedrag automatisch teruggezet op je saldo.

Kan ik mijn bestaande sms-activate-integratie gebruiken?

Ja. Vervang het basisadres door ons compatibele endpoint en gebruik je SmsGrab-sleutel. Standaardacties, antwoorden en numerieke ID’s blijven hetzelfde.

Welke snelheidslimieten gelden er?

Standaard kan elke sleutel 600 verzoeken en 60 aankopen per minuut doen, alle sleutels van een account samen 3.000 verzoeken per minuut, en maximaal 100 nummers kunnen tegelijk op een code wachten.

Hoe houd ik mijn sleutel veilig?

Bewaar sleutels alleen op je servers, geef elke app een eigen sleutel, beperk hem tot je serveradressen en stel een daglimiet in. Is een sleutel mogelijk uitgelekt, vervang of trek hem dan in via je account.

Delen de app en de API één saldo?

Ja. De API gebruikt het saldo van je SmsGrab-account, en elke aankoop en terugbetaling verschijnt gewoon in je wallet.

Meer antwoorden vind je in het helpcentrum

Klaar om verificatie te automatiseren?

Maak een sleutel in je account en doe binnen een paar minuten je eerste aanroep.

API-sleutel aanvragen Documentatie lezen