API Aktivasi SMS

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

Pengantar Nomor Verifikasi

Setiap panggilan adalah permintaan GET (atau POST) ke https://snsverify.com/stubs/handler_api.php dengan kunci API Anda dan parameter aksi. Kunci berasal dari halaman kunci API di konsol Anda; jaga kerahasiaannya, karena dapat menghabiskan saldo Anda. Jawaban berupa baris teks pendek seperti ACCESS_NUMBER atau STATUS_OK, atau JSON untuk aksi daftar, persis seperti layanan lain yang menggunakan format ini.

Akun yang sama, aturan yang sama. Nomor yang dibeli di sini menggunakan harga yang sama, jendela 20 menit yang sama, dan pengembalian dana otomatis yang sama seperti situs web. Kode layanan adalah nama huruf kecil yang Anda lihat di situs kami (whatsapp, telegram, google); kode 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) [+]

Saldo Anda dalam USD.

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

Jawaban

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Kode layanan yang dapat Anda beli (JSON).

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

Jawaban

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

getCountries (GET) [+]

Kode negara (ISO, huruf kecil) dan kode telepon (JSON).

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

Jawaban

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

getPrices (GET) [+]

Harga dalam USD per negara dan layanan. Kedua filter bersifat opsional.

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

Jawaban

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

getNumber (GET) [+]

Membeli nomor. Mengembalikan id aktivasi dan nomor dengan kode negaranya.

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

Jawaban

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (belum ada kode), STATUS_OK:<code>, STATUS_WAIT_RETRY:<kode terakhir> (permintaan kode lain), STATUS_CANCEL (dibatalkan atau dikembalikan).

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

Jawaban

STATUS_OK:482915

setStatus (GET) [+]

status=1 siap (ACCESS_READY), 3 kode lain (ACCESS_RETRY_GET), 6 selesai (ACCESS_ACTIVATION), 8 batalkan dengan pengembalian dana penuh saat belum ada kode yang masuk (ACCESS_CANCEL).

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

Jawaban

ACCESS_RETRY_GET

Alur Khas

Panggil getNumber dengan layanan dan negara. Simpan id aktivasi dan berikan nomor ke aplikasi.
Panggil setStatus dengan status=1 saat aplikasi telah mengirim SMS (opsional, hanya menandai aktivasi siap).
Polling getStatus setiap 3 hingga 5 detik hingga menjawab STATUS_OK dengan kode.
Butuh kode lain? setStatus status=3, lalu polling lagi hingga STATUS_OK menunjukkan kode baru.
Selesai: setStatus status=6. Tidak ada kode dan Anda ingin uang Anda kembali sekarang: setStatus status=8 (hanya sebelum kode masuk). Jika tidak, aktivasi akan mengembalikan dana sendiri setelah 20 menit.

Jawaban Kesalahan

BAD_KEY	Kunci API tidak ada atau salah.
BAD_ACTION	Aksi tidak dikenal.
BAD_SERVICE	Kode layanan tidak dikenal.
BAD_COUNTRY	Layanan tidak dijual di negara itu.
NO_BALANCE	Saldo tidak cukup.
NO_NUMBERS	Tidak ada nomor yang tersedia saat ini. Coba lagi sebentar lagi.
NO_ACTIVATION	Id aktivasi tidak dikenal, atau bukan milik Anda.
EARLY_CANCEL_DENIED	Kode sudah masuk, sehingga aktivasi tidak dapat dibatalkan.
TOO_MANY_REQUESTS	Lebih dari 300 permintaan dalam satu menit.
NO_ACTIVATIONS	Sudah ada 20 aktivasi yang terbuka.

Batas: 300 permintaan per menit per kunci, hingga 20 aktivasi terbuka per akun. Harga per 2026-11-04