SMS-активація API

Звичайний текстовий формат активації для інструментів, які вже його використовують. Нові інтеграції також можуть використовувати REST API.

Вступ до верифікаційних номерів

Кожен запит, це GET (або POST) запит до https://snsverify.com/stubs/handler_api.php з вашим API-ключем та параметром дії. Ключ береться зі сторінки API-ключа у вашому кабінеті; зберігайте його в таємниці, він може витрачати ваш баланс. Відповіді, це короткі текстові рядки, такі як ACCESS_NUMBER або STATUS_OK, або JSON для дій зі списками, так само, як у інших сервісів, які використовують цей формат.

Той самий акаунт, ті самі правила. Номери, куплені тут, використовують ті самі ціни, той самий 20-хвилинний вікно та той самий автоматичний повернення коштів, що й на сайті. Коди сервісів, це назви в нижньому регістрі, які ви бачите на нашому сайті (whatsapp, telegram, google); коди країн, 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) [+]

Ваш баланс в USD.

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

Відповідь

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Коди сервісів, які можна купити (JSON).

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

Відповідь

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

getCountries (GET) [+]

Коди країн (ISO, нижній регістр) та коди набору (JSON).

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

Відповідь

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

getPrices (GET) [+]

Ціни в USD за країну та сервіс. Обидва фільтри є необов'язковими.

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

Відповідь

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

getNumber (GET) [+]

Купує номер. Повертає ідентифікатор активації та номер з його кодом країни.

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

Відповідь

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (коду ще немає), STATUS_OK:<code>, STATUS_WAIT_RETRY:<останній код> (запит на інший код), STATUS_CANCEL (скасовано або повернено кошти).

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

Відповідь

STATUS_OK:482915

setStatus (GET) [+]

status=1 готовий (ACCESS_READY), 3 інший код (ACCESS_RETRY_GET), 6 завершити (ACCESS_ACTIVATION), 8 скасувати з повним поверненням коштів, якщо код не надійшов (ACCESS_CANCEL).

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

Відповідь

ACCESS_RETRY_GET

Типовий процес

Викличте getNumber з сервісом та країною. Збережіть ідентифікатор активації та передайте номер додатку.
Викличте setStatus з status=1, коли додаток надіслав SMS (необов'язково, це лише позначає активацію як готову).
Опитуйте getStatus кожні 3-5 секунд, поки він не відповість STATUS_OK з кодом.
Потрібен інший код? setStatus status=3, потім опитуйте знову, поки STATUS_OK не покаже новий код.
Готово: setStatus status=6. Немає коду, і ви хочете повернути свої гроші зараз: setStatus status=8 (лише до надходження коду). В іншому випадку активація автоматично повертає кошти через 20 хвилин.

Помилки

BAD_KEY	Відсутній або неправильний API-ключ.
BAD_ACTION	Невідома дія.
BAD_SERVICE	Невідомий код сервісу.
BAD_COUNTRY	Цей сервіс не продається у цій країні.
NO_BALANCE	Недостатньо коштів на балансі.
NO_NUMBERS	Наразі немає доступних номерів. Спробуйте ще раз через деякий час.
NO_ACTIVATION	Невідомий ідентифікатор активації або він не належить вам.
EARLY_CANCEL_DENIED	Код вже надійшов, тому активацію не можна скасувати.
TOO_MANY_REQUESTS	Більше 300 запитів за хвилину.
NO_ACTIVATIONS	Вже відкрито 20 активацій.

Обмеження: 300 запитів на хвилину на ключ, до 20 відкритих активацій на акаунт. Ціни станом на 2026-11-04