SMS 驗證 API

常見的純文字激活格式，適用於已使用此格式的工具。新整合亦可使用REST API。

驗證號碼簡介

每次呼叫均為向 https://snsverify.com/stubs/handler_api.php 發送 GET（或 POST）請求，需包含您的 API 金鑰及操作參數。金鑰來自控制台的 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) [+]

您的餘額 (美元)。

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) [+]

按國家及服務的美元價格。兩個篩選條件均為可選。

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:<last code>（已請求另一組代碼）、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 並將號碼提供予應用程式。
當應用程式已發送 SMS 時，使用 status=1 呼叫 setStatus（可選，僅標記激活為準備就緒）。
每隔 3 至 5 秒輪詢 getStatus，直至回傳 STATUS_OK 及代碼。
需要另一組代碼？使用 status=3 呼叫 setStatus，然後再次輪詢直至 STATUS_OK 顯示新代碼。
完成：使用 status=6 呼叫 setStatus。未收到代碼且希望立即退款：使用 status=8 呼叫 setStatus（僅限代碼到達前）。否則激活將於 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 價格