API pentru dezvoltatori
Verificare prin SMS direct din codul tău
Un singur apel HTTPS îi dă botului sau platformei tale un număr real pentru WhatsApp, Telegram și multe alte servicii. Citește codul prin webhook sau long polling și plătește doar numerele care primesc unul.
- 2.281servicii
- 200țări
- Automatrambursare când nu vine niciun cod
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": []
}
Construit pentru automatizare
Tot ce îi trebuie integrării tale, cu același stoc, aceeași contabilitate și aceleași rambursări ca aplicația.
-
Un API REST clar
JSON previzibil, cumpărări idempotente și motive de eroare clare, pe care poți acționa.
-
Webhookuri semnate
Evenimente semnate HMAC pentru fiecare cod și schimbare de stare, cu reîncercări timp de 24 de ore.
-
Long polling
Ține o cerere deschisă până la 25 de secunde și primești codul imediat ce sosește.
-
Compatibil cu sms-activate
Îndreaptă instrumentele existente spre o adresă nouă. Acțiunile și răspunsurile rămân aceleași.
-
Chei sub controlul tău
Chei doar pentru citire sau de cumpărare, liste de IP-uri permise, limite zilnice, expirare și rotire fără întreruperi.
-
Rambursări automate
N-a venit niciun cod înainte să expire numărul? Plata revine direct în soldul tău.
-
Utilizare și jurnal de cereri
Cereri, cheltuieli și erori zilnice pe fiecare cheie, plus un jurnal filtrabil al ultimelor 7 zile.
-
Prețuri de volum
Aceleași prețuri ca în aplicație, cu reduceri care cresc automat odată cu volumul lunar.
Pornești în patru pași
Primul tău număr e la doar câteva apeluri distanță.
-
Creează un cont
Înregistrează-te cu adresa de e-mail și verifică-o. Aplicația și site-ul folosesc același cont.
-
Creează o cheie API
Alege-i accesul, limitează-o la serverele tale și copiază secretul o singură dată.
-
Cumpără un număr
Trimite serviciul și țara prin POST. Primești imediat numărul și prețul lui.
-
Primește codul
Așteaptă cu long polling sau un webhook, apoi finalizează activarea.
Prețuri care scad pe măsură ce crești
API-ul aplică aceleași prețuri ca aplicația. Reducerea ta angro crește odată cu cheltuielile din ultimele 30 de zile pe toate canalele.
- Niciodată mai scump decât același număr în aplicație
- Numerele fără cod sunt rambursate automat
- Pragul tău se actualizează la câteva minute după ce îl atingi
- Taxat în USD din același sold ca aplicația
Migrare
Treci de la sms-activate cu un singur rând
Endpointul nostru compatibil vorbește același protocol, așa că boturile și panourile create pentru sms-activate funcționează după ce schimbi adresa de bază și cheia.
SMS-Activate s-a închis în decembrie 2025. Îndreaptă-ți instrumentele spre SmsGrab și vor funcționa în continuare.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber, getStatus, setStatus, getPrices și toate celelalte acțiuni standard
- ID-urile numerice de activare, codurile de serviciu și ID-urile de țară pe care le folosești deja
- Aceleași chei, limite, prețuri, rambursări și webhookuri ca API-ul REST
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)
}
}
În timp real
Coduri trimise direct pe serverul tău
Abonează-te la evenimentele care te interesează și le livrăm la endpointul tău HTTPS cu o semnătură pe care o poți verifica.
- Număr cumpărat
- Cod primit
- Activare finalizată
- Activare anulată
- Activare expirată
- Plată rambursată
- Sold scăzut
- Alimentare creată
- Alimentare în confirmare
- Alimentare creditată
- Alimentare expirată
- Alimentare în verificare
- Fiecare livrare este semnată cu HMAC-SHA256 și un marcaj de timp
- Doar endpointuri HTTPS publice, verificate înainte de fiecare livrare
- Livrări de test, istoric de 30 de zile și relivrare dintr-un clic
Întrebări de la dezvoltatori
Cât costă API-ul pentru dezvoltatori?
Nu există abonament. Fiecare număr costă la fel ca în aplicație și se plătește din același sold. Nivelurile de volum scad acest preț pe măsură ce cresc cheltuielile tale din 30 de zile, iar revânzătorii aprobați au o reducere fixă. Numerele fără cod se rambursează automat.
Ce se întâmplă dacă nu vine niciun cod?
Un număr este valabil până la ora de expirare afișată lângă el, de obicei între 10 și 20 de minute. Dacă în acest timp nu vine niciun cod sau îl anulezi cât încă așteaptă, plata îți este rambursată automat în sold.
Pot folosi integrarea mea sms-activate existentă?
Da. Înlocuiește adresa de bază cu endpointul nostru compatibil și folosește cheia ta SmsGrab. Acțiunile standard, răspunsurile și ID-urile numerice rămân aceleași.
Care sunt limitele de frecvență?
Implicit, fiecare cheie poate face 600 de cereri și 60 de cumpărări pe minut, toate cheile unui cont împreună 3.000 de cereri pe minut, iar până la 100 de numere pot aștepta un cod în același timp.
Cum îmi păstrez cheia în siguranță?
Păstrează cheile doar pe servere, dă fiecărei aplicații propria cheie, limitează-o la adresele serverelor și setează o limită zilnică de cheltuieli. Dacă o cheie ar fi putut fi expusă, rotește-o sau revoc-o din cont.
Găsești mai multe răspunsuri în centrul de ajutor