SmsGrab

Motyw

Zaloguj się Polski

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ą.

Uzyskaj klucz API Przeczytaj dokumentację
  • 1 321usług
  • 145krajów
  • 0,10 USDminimalna cena za numer
  • Autozwrot, gdy kod nie przyjdzie

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

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

    Ceny oparte na koszcie hurtowym, które same spadają, gdy rośnie Twój miesięczny wolumen.

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ę.

Otwórz szybki start

Ceny, które spadają wraz z Twoim rozwojem

Ceny deweloperskie zaczynają się od kosztu hurtowego numeru plus marży, która maleje wraz z Twoim wolumenem z 30 dni.

  • Nigdy drożej niż ten sam numer w aplikacji
  • Co najmniej 0,10 USD za numer
  • 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

Marża według wydatków deweloperskich z 30 dni

Wydatki deweloperskie z 30 dni Marża na cenie hurtowej Przykładowa cena
Poniżej 100,00 USD +80% 0,18 USD o 28% taniej niż w aplikacji
Od 100,00 USD +70% 0,17 USD o 32% taniej niż w aplikacji
Od 500,00 USD +60% 0,16 USD o 36% taniej niż w aplikacji
Od 2 000,00 USD +50% 0,15 USD o 40% taniej niż w aplikacji

Przykład: oferta o koszcie hurtowym 0,10 USD, która w aplikacji kosztuje 0,25 USD.

Uzyskaj klucz API

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.

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 "$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)

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
Przewodnik po webhookach
600żądań na minutę na klucz
60zakupów na minutę na klucz
100numerów oczekujących jednocześnie
30sekund 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 cenę hurtową plus 80% marży, która spada do 70%, 60% i 50%, gdy Twoje wydatki deweloperskie z 30 dni przekroczą 100, 500 i 2000 USD. Numer nigdy nie kosztuje mniej niż 0,10 USD ani więcej niż w aplikacji.

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

Numer jest ważny 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.

Uzyskaj klucz API Przeczytaj dokumentację