簡訊驗證 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":0}}}

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 的價格