API Aktywacji SMS

Wspólny format aktywacji w postaci zwykłego tekstu, dla narzędzi, które już go używają. Nowe integracje mogą również korzystać z REST API.

Wprowadzenie do numerów weryfikacyjnych

Każde wywołanie jest żądaniem GET (lub POST) do https://snsverify.com/stubs/handler_api.php z kluczem API i parametrem akcji. Klucz pochodzi ze strony klucza API w Twojej konsoli; zachowaj go w tajemnicy, może wydawać Twoje saldo. Odpowiedzi to krótkie linie tekstu, takie jak ACCESS_NUMBER lub STATUS_OK, lub JSON dla akcji listowych, dokładnie jak w innych usługach korzystających z tego formatu.

To samo konto, te same zasady. Numery kupione tutaj korzystają z tych samych cen, tego samego 20 minutowego okna i tej samej automatycznej zwrotu jak strona internetowa. Kody usług to nazwy pisane małymi literami, które widzisz na naszej stronie (whatsapp, telegram, google); kody krajów to ISO: us, gb, nl, de, af, al, dz, ao, ai, ar, am, aw, au, at, az, bs, bh, bd, bb, by, be, bz, bj, bt, bo, ba, bw, br, bn, bg, bi, kh, cm, ca, td, cl, cn, co, km, hr, cy, cz, dk, dj, dm, ec, eg, er, ee, sz, et, fj, fi, fr, ga, gm, ge, gh, gi, gr, gd, gp, gt, gn, gy, ht, hn, hk, hu, is, in, id, iq, ie, il, it, jm, jp, jo, kz, ke, kw, kg, la, lv, lb, ls, lr, lt, lu, mo, mg, mw, my, mv, ml, mt, mr, mu, mx, md, mc, mn, me, ms, ma, mz, na, np, nz, ni, ne, ng, no, om, pk, pa, py, pe, ph, pl, pt, qa, ro, rw, sn, rs, sc, sg, sk, si, so, za, es, sr, se, ch, tw, tj, tz, th, tg, tn, tr, tm, ug, ua, uy, uz, ve, vn, ye, zm, zw.

getBalance (GET) [+]

Twoje saldo w USD.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getBalance

Odpowiedź

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Kody usług, które możesz kupić (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getServicesList

Odpowiedź

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries (GET) [+]

Kody krajów (ISO, małe litery) i kody wybierania (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getCountries

Odpowiedź

{"gb":{"name":"United Kingdom","dial":"44"}}

getPrices (GET) [+]

Ceny w USD za kraj i usługę. Oba filtry są opcjonalne.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getPrices&service=whatsapp&country=gb

Odpowiedź

{"gb":{"whatsapp":{"cost":0.94,"count":100}}}

getNumber (GET) [+]

Kupuje numer. Zwraca identyfikator aktywacji i numer z jego kodem kraju.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=whatsapp&country=gb

Odpowiedź

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (jeszcze nie ma kodu), STATUS_OK:<code>, STATUS_WAIT_RETRY:<ostatni kod> (zapytano o kolejny kod), STATUS_CANCEL (anulowane lub zwrócone).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getStatus&id=AC-7K2M9QX4PB

Odpowiedź

STATUS_OK:482915

setStatus (GET) [+]

status=1 gotowy (ACCESS_READY), 3 kolejny kod (ACCESS_RETRY_GET), 6 zakończ (ACCESS_ACTIVATION), 8 anuluj z pełnym zwrotem, gdy nie dotarł kod (ACCESS_CANCEL).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

Odpowiedź

ACCESS_RETRY_GET

Typowy przepływ

Wywołaj getNumber z usługą i krajem. Zapisz identyfikator aktywacji i podaj numer aplikacji.
Wywołaj setStatus z statusem=1, gdy aplikacja wysłała SMS (opcjonalnie, tylko oznacza aktywację jako gotową).
Sprawdzaj getStatus co 3 do 5 sekund, aż odpowie STATUS_OK z kodem.
Potrzebujesz kolejnego kodu? setStatus status=3, a następnie sprawdzaj ponownie, aż STATUS_OK pokaże nowy kod.
Gotowe: setStatus status=6. Nie ma kodu i chcesz zwrotu pieniędzy teraz: setStatus status=8 (tylko przed dotarciem kodu). W przeciwnym razie aktywacja zwraca się automatycznie po 20 minutach.

Odpowiedzi błędów

BAD_KEY	Brakujący lub błędny klucz API.
BAD_ACTION	Nieznana akcja.
BAD_SERVICE	Nieznany kod usługi.
BAD_COUNTRY	Usługa nie jest sprzedawana w tym kraju.
NO_BALANCE	Niewystarczające saldo.
NO_NUMBERS	Brak dostępnego numeru w tej chwili. Spróbuj ponownie za chwilę.
NO_ACTIVATION	Nieznany identyfikator aktywacji lub nie należy do Ciebie.
EARLY_CANCEL_DENIED	Kod już dotarł, więc aktywacja nie może zostać anulowana.
TOO_MANY_REQUESTS	Ponad 300 żądań w ciągu minuty.
NO_ACTIVATIONS	Już jest otwartych 20 aktywacji.

Limity: 300 żądań na minutę na klucz, do 20 otwartych aktywacji na konto. Ceny na dzień 2026-11-04