API для SMS-активации

Общий текстовый формат активации для инструментов, которые уже его используют. Новые интеграции также могут использовать REST API.

Введение в верификационные номера

Каждый вызов, это GET (или POST) запрос к https://snsverify.com/stubs/handler_api.php с вашим API-ключом и параметром action. Ключ берётся со страницы 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) [+]

Покупает номер. Возвращает ID активации и номер с кодом страны.

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 с сервисом и страной. Сохраните ID активации и передайте номер приложению.
Вызовите 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	Неизвестный ID активации или не ваш.
EARLY_CANCEL_DENIED	Код уже пришёл, поэтому активацию нельзя отменить.
TOO_MANY_REQUESTS	Более 300 запросов в минуту.
NO_ACTIVATIONS	Уже открыто 20 активаций.

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