SMS Activation API

Ang common plain-text activation format, para sa mga tool na gumagamit na nito. Maaari ring gamitin ng mga bagong integration ang REST API.

Panimula sa Verification Numbers

Ang bawat tawag ay isang GET (o POST) na kahilingan sa https://snsverify.com/stubs/handler_api.php gamit ang iyong API key at isang action parameter. Ang key ay nagmumula sa API key page ng iyong console; panatilihing pribado, maaari itong gastusin ang iyong credit. Ang mga sagot ay maiksing text lines tulad ng ACCESS_NUMBER o STATUS_OK, o JSON para sa mga list actions, eksaktong tulad ng iba pang serbisyo na gumagamit ng format na ito.

Parehong account, parehong mga patakaran. Ang mga numero na binili dito ay gumagamit ng parehong presyo, parehong 20 minutong window at parehong awtomatikong refund tulad ng website. Ang mga service code ay ang lower-case na mga pangalan na nakikita mo sa aming site (whatsapp, telegram, google); ang mga country code ay 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) [+]

Ang iyong credit sa USD.

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

Sagot

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Mga service code na maaari mong bilhin (JSON).

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

Sagot

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

getCountries (GET) [+]

Mga country code (ISO, lower case) at dial code (JSON).

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

Sagot

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

getPrices (GET) [+]

Mga presyo sa USD at bilang ng stock bawat bansa at serbisyo. Parehong filter ay opsyonal.

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

Sagot

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

getNumber (GET) [+]

Bumili ng numero. Nagbabalik ng activation id at ang numero kasama ang country code nito.

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

Sagot

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (wala pang code), STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (hiniling ang isa pang code), STATUS_CANCEL (kinansela o nirefund).

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

Sagot

STATUS_OK:482915

setStatus (GET) [+]

status=1 ready (ACCESS_READY), 3 another code (ACCESS_RETRY_GET), 6 finish (ACCESS_ACTIVATION), 8 cancel na may buong refund habang walang code na dumating (ACCESS_CANCEL).

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

Sagot

ACCESS_RETRY_GET

Karaniwang Daloy

Tumawag ng getNumber gamit ang service at country. I-save ang activation id at ibigay ang numero sa app.
Tumawag ng setStatus gamit ang status=1 kapag nagpadala na ng SMS ang app (opsyonal, minamarkahan lang nito ang activation na ready).
Poll ang getStatus tuwing 3 hanggang 5 segundo hanggang sa magsagot ito ng STATUS_OK kasama ang code.
Kailangan ng isa pang code? setStatus status=3, pagkatapos ay mag-poll ulit hanggang sa magpakita ang STATUS_OK ng bagong code.
Tapos na: setStatus status=6. Walang code at gusto mong mabawi ang iyong pera ngayon: setStatus status=8 (lamang bago dumating ang code). Kung hindi, ang activation ay magre-refund sa sarili nito pagkatapos ng 20 minuto.

Mga Sagot sa Error

BAD_KEY	Nawawala o maling API key.
BAD_ACTION	Hindi kilalang action.
BAD_SERVICE	Hindi kilalang service code.
BAD_COUNTRY	Ang serbisyo ay hindi ibinebenta sa bansang iyon.
NO_BALANCE	Hindi sapat na credit.
NO_NUMBERS	Walang available na numero ngayon. Subukan ulit sa ilang sandali.
NO_ACTIVATION	Hindi kilalang activation id, o hindi sa iyo.
EARLY_CANCEL_DENIED	May code na dumating, kaya hindi maaaring kanselahin ang activation.
TOO_MANY_REQUESTS	Higit sa 300 na kahilingan sa isang minuto.
NO_ACTIVATIONS	20 na activation ang bukas na.

Mga limitasyon: 300 na kahilingan bawat minuto bawat key, hanggang 20 na bukas na activation bawat account. Mga presyo hanggang 2026-11-04