API Pengaktifan SMS

Format pengaktifan teks biasa, untuk alat yang sudah menggunakannya. Integrasi baru juga boleh menggunakan API REST.

Pengenalan Nombor Pengesahan

Setiap panggilan adalah permintaan GET (atau POST) ke https://snsverify.com/stubs/handler_api.php dengan kunci API anda dan parameter tindakan. Kunci tersebut berasal dari halaman kunci API di konsol anda; simpan secara rahsia, ia boleh menggunakan kredit anda. Jawapan adalah baris teks pendek seperti ACCESS_NUMBER atau STATUS_OK, atau JSON untuk tindakan senarai, sama seperti perkhidmatan lain yang menggunakan format ini.

Akaun yang sama, peraturan yang sama. Nombor yang dibeli di sini menggunakan harga yang sama, tempoh 20 minit dan bayaran balik automatik yang sama seperti laman web. Kod perkhidmatan adalah nama huruf kecil yang anda lihat di laman kami (whatsapp, telegram, google); kod negara adalah 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) [+]

Kredit anda dalam USD.

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

Jawapan

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Kod perkhidmatan yang boleh dibeli (JSON).

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

Jawapan

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

getCountries (GET) [+]

Kod negara (ISO, huruf kecil) dan kod dail (JSON).

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

Jawapan

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

getPrices (GET) [+]

Harga dalam USD setiap negara dan perkhidmatan. Kedua-dua penapis adalah pilihan.

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

Jawapan

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

getNumber (GET) [+]

Membeli nombor. Mengembalikan id pengaktifan dan nombor dengan kod negaranya.

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

Jawapan

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (tiada kod lagi), STATUS_OK:<code>, STATUS_WAIT_RETRY:<kod terakhir> (permintaan kod lain), STATUS_CANCEL (dibatalkan atau dibayar balik).

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

Jawapan

STATUS_OK:482915

setStatus (GET) [+]

status=1 sedia (ACCESS_READY), 3 kod lain (ACCESS_RETRY_GET), 6 selesai (ACCESS_ACTIVATION), 8 batalkan dengan bayaran balik penuh semasa tiada kod tiba (ACCESS_CANCEL).

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

Jawapan

ACCESS_RETRY_GET

Aliran Biasa

Panggil getNumber dengan perkhidmatan dan negara. Simpan id pengaktifan dan berikan nombor kepada apl.
Panggil setStatus dengan status=1 apabila apl telah menghantar SMS (pilihan, ia hanya menandakan pengaktifan sedia).
Jajaki getStatus setiap 3 hingga 5 saat sehingga ia menjawab STATUS_OK dengan kod.
Perlukan kod lain? setStatus status=3, kemudian jajaki lagi sehingga STATUS_OK menunjukkan kod baru.
Selesai: setStatus status=6. Tiada kod dan anda mahu wang anda kembali sekarang: setStatus status=8 (hanya sebelum kod tiba). Jika tidak, pengaktifan akan membayar balik sendiri selepas 20 minit.

Jawapan Ralat

BAD_KEY	Kunci API hilang atau salah.
BAD_ACTION	Tindakan tidak diketahui.
BAD_SERVICE	Kod perkhidmatan tidak diketahui.
BAD_COUNTRY	Perkhidmatan tidak dijual di negara itu.
NO_BALANCE	Kredit tidak mencukupi.
NO_NUMBERS	Tiada nombor tersedia sekarang. Cuba lagi sebentar.
NO_ACTIVATION	Id pengaktifan tidak diketahui, atau bukan milik anda.
EARLY_CANCEL_DENIED	Kod sudah tiba, jadi pengaktifan tidak boleh dibatalkan.
TOO_MANY_REQUESTS	Lebih daripada 300 permintaan dalam satu minit.
NO_ACTIVATIONS	20 pengaktifan sudah dibuka.

Had: 300 permintaan seminit setiap kunci, sehingga 20 pengaktifan terbuka setiap akaun. Harga setakat 2026-11-04