SmsGrab

Temă

Conectează-te Română

Alege o limbă

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.

Obține o cheie API Citește documentația
  • 1.321servicii
  • 145țări
  • 0,10 USDpreț minim pe număr
  • 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 "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": []
}

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 30 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

    Prețuri bazate pe costul en-gros care scad singure pe măsură ce crește volumul tău lunar.

Pornești în patru pași

Primul tău număr e la doar câteva apeluri distanță.

  1. Creează un cont

    Înregistrează-te cu adresa de e-mail și verifică-o. Aplicația și site-ul folosesc același cont.

  2. Creează o cheie API

    Alege-i accesul, limitează-o la serverele tale și copiază secretul o singură dată.

  3. Cumpără un număr

    Trimite serviciul și țara prin POST. Primești imediat numărul și prețul lui.

  4. Primește codul

    Așteaptă cu long polling sau un webhook, apoi finalizează activarea.

Deschide ghidul rapid

Prețuri care scad pe măsură ce crești

Prețurile pentru dezvoltatori pornesc de la costul en-gros al fiecărui număr plus un adaos care scade odată cu volumul tău din 30 de zile.

  • Niciodată mai scump decât același număr în aplicație
  • Cel puțin 0,10 USD pe număr
  • 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

Adaos după cheltuielile de dezvoltator din 30 de zile

Cheltuieli de dezvoltator în 30 de zile Adaos la prețul en-gros Preț exemplu
Sub 100,00 USD +80% 0,18 USD cu 28% mai ieftin decât în aplicație
De la 100,00 USD +70% 0,17 USD cu 32% mai ieftin decât în aplicație
De la 500,00 USD +60% 0,16 USD cu 36% mai ieftin decât în aplicație
De la 2.000,00 USD +50% 0,15 USD cu 40% mai ieftin decât în aplicație

Exemplu: o ofertă cu un cost en-gros de 0,10 USD care costă 0,25 USD în aplicație.

Obține o cheie API

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.

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
Referință de compatibilitate

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)

Î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
Ghid pentru webhookuri
600cereri pe minut pe cheie
60cumpărări pe minut pe cheie
100numere în așteptare simultan
30secunde de long polling
  • 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ă prețul en-gros plus un adaos de 80%, care scade la 70%, 60% și 50% când cheltuielile tale de dezvoltator din 30 de zile trec de 100, 500 și 2.000 USD. Un număr nu costă niciodată sub 0,10 USD și nici peste prețul din aplicație.

Ce se întâmplă dacă nu vine niciun cod?

Un număr este valabil 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.

Aplicația și API-ul folosesc același sold?

Da. API-ul folosește soldul contului tău SmsGrab, iar fiecare cumpărare și rambursare apare în portofel ca oricare alta.

Găsești mai multe răspunsuri în centrul de ajutor

Gata să automatizezi verificarea?

Creează o cheie în contul tău și fă primul apel în câteva minute.

Obține o cheie API Citește documentația