短信验证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 并将号码提供给应用程序。
当应用程序发送短信时，调用 setStatus 并设置 status=1（可选，仅标记激活为准备就绪）。
每 3 到 5 秒轮询一次 getStatus，直到它返回 STATUS_OK 和代码。
需要另一个代码？设置 setStatus status=3，然后再次轮询，直到 STATUS_OK 显示新代码。
完成：设置 setStatus status=6。未收到代码且您现在想要退款：设置 setStatus status=8（仅在代码到达之前）。否则，激活将在 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 的价格