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)
{
"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ń.
-
Załóż konto
Zarejestruj się adresem e-mail i zweryfikuj go. Aplikacja i strona korzystają z tego samego konta.
-
Utwórz klucz API
Wybierz jego dostęp, ogranicz go do swoich serwerów i raz skopiuj sekret.
-
Kup numer
Wyślij usługę i kraj metodą POST. Od razu dostajesz numer i jego cenę.
-
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
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
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
- 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.
Więcej odpowiedzi znajdziesz w centrum pomocy