Wybierz język

API dla deweloperów

Weryfikacja SMS prosto z Twojego kodu

Jedno wywołanie HTTPS daje Twojemu botowi lub platformie prawdziwy numer do WhatsAppa, Telegrama i wielu innych usług. Odczytaj kod przez webhook lub long polling i płać tylko za numery, które go otrzymają.

  • 2 281usług
  • 200krajów
  • Autozwrot, gdy kod nie przyjdzie

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": []
}

Stworzone do automatyzacji

Wszystko, czego potrzebuje Twoja integracja, z tym samym zapasem, księgowością i zwrotami co aplikacja.

  • Przejrzyste REST API

    Przewidywalny JSON, idempotentne zakupy i jasne przyczyny błędów, na które możesz reagować.

  • Podpisane webhooki

    Zdarzenia podpisane HMAC dla każdego kodu i zmiany statusu, z ponowieniami przez 24 godziny.

  • Long polling

    Wstrzymaj żądanie do 25 sekund i odbierz kod w chwili, gdy przyjdzie.

  • Zgodność z sms-activate

    Wskaż swoim narzędziom nowy adres. Akcje i odpowiedzi pozostają takie same.

  • Klucze pod Twoją kontrolą

    Klucze tylko do odczytu lub zakupowe, listy dozwolonych IP, dzienne limity, data wygaśnięcia i wymiana bez przestojów.

  • Automatyczne zwroty

    Brak kodu, zanim numer wygaśnie? Opłata wraca prosto na Twoje saldo.

  • Wykorzystanie i dziennik żądań

    Dzienne żądania, wydatki i błędy dla każdego klucza oraz filtrowany dziennik z ostatnich 7 dni.

  • Ceny wolumenowe

    Te same ceny co w aplikacji, z rabatami, które rosną automatycznie wraz z miesięcznym wolumenem.

Start w czterech krokach

Twój pierwszy numer dzieli tylko kilka wywołań.

  1. Załóż konto

    Zarejestruj się adresem e-mail i zweryfikuj go. Aplikacja i strona korzystają z tego samego konta.

  2. Utwórz klucz API

    Wybierz jego dostęp, ogranicz go do swoich serwerów i raz skopiuj sekret.

  3. Kup numer

    Wyślij usługę i kraj metodą POST. Od razu dostajesz numer i jego cenę.

  4. Odbierz kod

    Czekaj z long pollingiem lub webhookiem, a potem zakończ aktywację.

Ceny, które spadają wraz z Twoim rozwojem

API pobiera te same ceny co aplikacja. Twój rabat hurtowy rośnie razem z wydatkami z ostatnich 30 dni we wszystkich kanałach.

  • Nigdy drożej niż ten sam numer w aplikacji
  • Numery bez kodu są zwracane automatycznie
  • Twój próg aktualizuje się kilka minut po jego osiągnięciu
  • Rozliczane w USD z tego samego salda co aplikacja

Rabat według wydatków w 30 dni

Progi ilościowe są teraz nieaktywne. Płacisz te same ceny co w aplikacji, a zatwierdzeni odsprzedawcy dostają swój stały rabat.

Migracja

Przejdź z sms-activate jedną linijką

Nasz zgodny punkt końcowy używa tego samego protokołu, więc boty i panele stworzone dla sms-activate działają po zmianie adresu bazowego i klucza.

SMS-Activate zakończył działalność w grudniu 2025. Skieruj swoje narzędzia na SmsGrab, a będą działać dalej.

https://smsgrab.com/api/stubs/handler_api.php
  • getNumber, getStatus, setStatus, getPrices i wszystkie inne standardowe akcje
  • Liczbowe ID aktywacji, kody usług i ID krajów, których już używasz
  • Te same klucze, limity, ceny, zwroty i webhooki co w REST API
Dokumentacja zgodności

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)
	}
}

Czas rzeczywisty

Kody wysyłane na Twój serwer

Subskrybuj interesujące Cię zdarzenia, a dostarczymy je do Twojego punktu końcowego HTTPS z podpisem, który możesz sprawdzić.

  • Kupiono numer
  • Otrzymano kod
  • Aktywacja zakończona
  • Aktywacja anulowana
  • Aktywacja wygasła
  • Zwrócono opłatę
  • Niskie saldo
  • Doładowanie utworzone
  • Doładowanie w potwierdzaniu
  • Doładowanie zaksięgowane
  • Doładowanie wygasło
  • Doładowanie w weryfikacji
Przewodnik po webhookach
600żądań na minutę na klucz
60zakupów na minutę na klucz
100numerów oczekujących jednocześnie
25sekund long pollingu
  • Każde dostarczenie jest podpisane HMAC-SHA256 ze znacznikiem czasu
  • Tylko publiczne punkty końcowe HTTPS, sprawdzane przed każdym dostarczeniem
  • Dostarczenia testowe, 30-dniowa historia i ponowne dostarczenie jednym kliknięciem

Pytania deweloperów

Ile kosztuje API dla deweloperów?

Nie ma abonamentu. Każdy numer kosztuje tyle samo co w aplikacji i jest opłacany z tego samego salda. Progi ilościowe obniżają tę cenę wraz ze wzrostem wydatków z 30 dni, a zatwierdzeni odsprzedawcy mają stały rabat. Numery bez kodu są zwracane automatycznie.

Co się stanie, jeśli kod nie przyjdzie?

Numer jest ważny do pokazanego przy nim czasu wygaśnięcia, zwykle od 10 do 20 minut. Jeśli w tym czasie nie przyjdzie żaden kod albo anulujesz go, gdy jeszcze czeka, opłata zostanie automatycznie zwrócona na Twoje saldo.

Czy mogę użyć mojej obecnej integracji z sms-activate?

Tak. Zamień adres bazowy na nasz zgodny punkt końcowy i użyj klucza SmsGrab. Standardowe akcje, odpowiedzi i liczbowe ID pozostają takie same.

Jakie są limity częstotliwości?

Domyślnie każdy klucz może wykonać 600 żądań i 60 zakupów na minutę, wszystkie klucze konta razem 3000 żądań na minutę, a jednocześnie na kod może czekać do 100 numerów.

Jak chronić klucz?

Trzymaj klucze tylko na serwerach, daj każdej aplikacji osobny klucz, ogranicz go do adresów serwerów i ustaw dzienny limit wydatków. Jeśli klucz mógł wyciec, wymień go lub unieważnij na swoim koncie.

Czy aplikacja i API korzystają z jednego salda?

Tak. API korzysta z salda Twojego konta SmsGrab, a każdy zakup i zwrot pojawia się w portfelu jak każdy inny.

Więcej odpowiedzi znajdziesz w centrum pomocy

Gotowy, by zautomatyzować weryfikację?

Utwórz klucz na swoim koncie i wykonaj pierwsze wywołanie w kilka minut.