API kích hoạt SMS

Định dạng kích hoạt văn bản thuần thông thường, dành cho các công cụ đã sử dụng nó. Các tích hợp mới cũng có thể sử dụng REST API.

Giới thiệu Số Xác Minh

Mỗi lần gọi là một yêu cầu GET (hoặc POST) tới https://snsverify.com/stubs/handler_api.php với khóa API của bạn và tham số action. Khóa được lấy từ trang khóa API trong bảng điều khiển của bạn; giữ nó bí mật, nó có thể sử dụng số dư của bạn. Câu trả lời là các dòng văn bản ngắn như ACCESS_NUMBER hoặc STATUS_OK, hoặc JSON cho các hành động danh sách, giống hệt như các dịch vụ khác sử dụng định dạng này.

Cùng một tài khoản, cùng quy tắc. Số mua tại đây sử dụng cùng mức giá, cùng cửa sổ 20 phút và cùng hoàn tiền tự động như trang web. Mã dịch vụ là các tên viết thường bạn thấy trên trang web của chúng tôi (whatsapp, telegram, google); mã quốc gia là 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) [+]

Số dư của bạn bằng USD.

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

Trả lời

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Mã dịch vụ bạn có thể mua (JSON).

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

Trả lời

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

getCountries (GET) [+]

Mã quốc gia (ISO, viết thường) và mã quay số (JSON).

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

Trả lời

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

getPrices (GET) [+]

Giá tính bằng USD theo quốc gia và dịch vụ. Cả hai bộ lọc đều tùy chọn.

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

Trả lời

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

getNumber (GET) [+]

Mua một số. Trả về id kích hoạt và số với mã quốc gia của nó.

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

Trả lời

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (chưa có mã), STATUS_OK:<code>, STATUS_WAIT_RETRY:<last code> (yêu cầu mã khác), STATUS_CANCEL (đã hủy hoặc hoàn tiền).

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

Trả lời

STATUS_OK:482915

setStatus (GET) [+]

status=1 sẵn sàng (ACCESS_READY), 3 mã khác (ACCESS_RETRY_GET), 6 hoàn tất (ACCESS_ACTIVATION), 8 hủy với hoàn tiền đầy đủ khi chưa có mã đến (ACCESS_CANCEL).

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

Trả lời

ACCESS_RETRY_GET

Quy trình Điển hình

Gọi getNumber với dịch vụ và quốc gia. Lưu id kích hoạt và cung cấp số cho ứng dụng.
Gọi setStatus với status=1 khi ứng dụng đã gửi SMS (tùy chọn, nó chỉ đánh dấu kích hoạt sẵn sàng).
Kiểm tra getStatus mỗi 3 đến 5 giây cho đến khi nhận được câu trả lời STATUS_OK với mã.
Cần mã khác? setStatus status=3, sau đó kiểm tra lại cho đến khi STATUS_OK hiển thị mã mới.
Hoàn tất: setStatus status=6. Không có mã và bạn muốn hoàn tiền ngay bây giờ: setStatus status=8 (chỉ trước khi mã đến). Nếu không, kích hoạt sẽ tự động hoàn tiền sau 20 phút.

Câu trả lời Lỗi

BAD_KEY	Thiếu hoặc sai khóa API.
BAD_ACTION	Hành động không xác định.
BAD_SERVICE	Mã dịch vụ không xác định.
BAD_COUNTRY	Dịch vụ không được bán tại quốc gia đó.
NO_BALANCE	Không đủ số dư.
NO_NUMBERS	Hiện không có số nào khả dụng. Thử lại sau.
NO_ACTIVATION	Id kích hoạt không xác định, hoặc không phải của bạn.
EARLY_CANCEL_DENIED	Mã đã đến, nên không thể hủy kích hoạt.
TOO_MANY_REQUESTS	Hơn 300 yêu cầu trong một phút.
NO_ACTIVATIONS	Đã có 20 kích hoạt đang mở.

Giới hạn: 300 yêu cầu mỗi phút mỗi khóa, tối đa 20 kích hoạt mở mỗi tài khoản. Giá tính đến 2026-11-04