API pro vývojáře
Ověření přes SMS přímo z vašeho kódu
Jediné volání HTTPS dá vašemu botovi nebo platformě skutečné číslo pro WhatsApp, Telegram a mnoho dalších služeb. Kód čtěte přes webhook nebo long polling a plaťte jen za čísla, která ho dostanou.
- 2 281služeb
- 200zemí
- Automatickyvrácení, když kód nedorazí
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": []
}
Vytvořeno pro automatizaci
Vše, co vaše integrace potřebuje, se stejnými zásobami, účetnictvím a refundacemi jako aplikace.
-
Přehledné REST API
Předvídatelný JSON, idempotentní nákupy a jasné důvody chyb, podle kterých můžete jednat.
-
Podepsané webhooky
Události podepsané HMAC pro každý kód a změnu stavu, s opakováním po dobu 24 hodin.
-
Long polling
Podržte požadavek až 25 sekund a kód dostanete v okamžiku, kdy dorazí.
-
Kompatibilní se sms-activate
Nasměrujte své nástroje na novou adresu. Akce i odpovědi zůstávají stejné.
-
Klíče pod vaší kontrolou
Klíče jen pro čtení nebo s nákupy, seznamy povolených IP, denní limity, vypršení a obměna bez výpadku.
-
Automatické refundace
Kód nedorazil, než číslo vypršelo? Platba se vrátí přímo na váš zůstatek.
-
Využití a protokol požadavků
Denní požadavky, útraty a chyby pro každý klíč a filtrovatelný protokol za posledních 7 dní.
-
Objemové ceny
Stejné ceny jako v aplikaci, se slevami, které automaticky rostou s měsíčním objemem.
Spuštění ve čtyřech krocích
Od prvního čísla vás dělí jen pár volání.
-
Vytvořte účet
Zaregistrujte se e-mailovou adresou a ověřte ji. Aplikace i web sdílejí stejný účet.
-
Vytvořte klíč API
Zvolte přístup, omezte ho na své servery a jednou zkopírujte tajný klíč.
-
Kupte číslo
Pošlete službu a zemi metodou POST. Číslo i cenu dostanete okamžitě.
-
Přijměte kód
Čekejte s long pollingem nebo webhookem a pak aktivaci dokončete.
Ceny, které klesají, jak rostete
API účtuje stejné ceny jako aplikace. Vaše velkoobchodní sleva roste s útratami za posledních 30 dní ve všech kanálech.
- Nikdy dražší než stejné číslo v aplikaci
- Čísla bez kódu se vracejí automaticky
- Vaše úroveň se aktualizuje pár minut po jejím dosažení
- Účtováno v USD ze stejného zůstatku jako aplikace
Přechod
Přejděte ze sms-activate jedním řádkem
Náš kompatibilní koncový bod mluví stejným protokolem, takže boti a panely pro sms-activate fungují po změně základní adresy a klíče.
SMS-Activate v prosinci 2025 skončil. Nasměrujte své nástroje na SmsGrab a budou fungovat dál.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices a všechny další standardní akce
- Číselná ID aktivací, kódy služeb a ID zemí, které už používáte
- Stejné klíče, limity, ceny, refundace a webhooky jako 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)
}
}
V reálném čase
Kódy doručené na váš server
Přihlaste se k odběru událostí, které vás zajímají, a doručíme je na váš koncový bod HTTPS s ověřitelným podpisem.
- Číslo koupeno
- Kód přijat
- Aktivace dokončena
- Aktivace zrušena
- Aktivace vypršela
- Platba vrácena
- Docházející zůstatek
- Dobití vytvořeno
- Dobití se potvrzuje
- Dobití připsáno
- Dobití vypršelo
- Dobití v kontrole
- Každé doručení je podepsané HMAC-SHA256 s časovým razítkem
- Jen veřejné koncové body HTTPS, kontrolované před každým doručením
- Testovací doručení, 30denní historie a nové doručení jedním kliknutím
Otázky vývojářů
Kolik stojí API pro vývojáře?
Žádné předplatné. Každé číslo stojí stejně jako v aplikaci a platí se ze stejného zůstatku. Objemové úrovně tuto cenu snižují, jak rostou vaše útraty za 30 dní, a schválení přeprodejci mají pevnou slevu. Čísla bez kódu se vracejí automaticky.
Co když kód nedorazí?
Číslo platí do uvedeného času vypršení, obvykle 10 až 20 minut. Pokud během této doby žádný kód nedorazí, nebo ho zrušíte, dokud ještě čeká, platba se automaticky vrátí na váš zůstatek.
Mohu použít stávající integraci se sms-activate?
Ano. Nahraďte základní adresu naším kompatibilním koncovým bodem a použijte svůj klíč SmsGrab. Standardní akce, odpovědi i číselná ID zůstávají stejné.
Jaké jsou limity četnosti?
Ve výchozím nastavení může každý klíč provést 600 požadavků a 60 nákupů za minutu, všechny klíče účtu dohromady 3 000 požadavků za minutu a současně může na kód čekat až 100 čísel.
Jak ochránit svůj klíč?
Klíče držte jen na serverech, dejte každé aplikaci vlastní klíč, omezte ho na adresy serverů a nastavte denní limit útraty. Pokud klíč mohl uniknout, obměňte ho nebo zrušte ve svém účtu.
Další odpovědi najdete v centru nápovědy