SMS 验证 API

SNSSIM API通过单次HTTP请求处理号码购买、验证码确认、取消、积分及价格查询。采用行业标准的handler_api方式,只需在现有程序中更改地址和API密钥即可立即连接。

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
行业标准方式
handler_api

行业标准方式

每个API密钥
每分钟300次

每个API密钥

国家 / 服务
145 / 1,255

国家 / 服务

如果没有收到验证码,自动退款
20 分钟

如果没有收到验证码,自动退款

如何获取API密钥?

登录后,在账户页面的 API 菜单中生成密钥。密钥仅在生成时显示一次,请立即保存。API 使用与网页相同的信用和价格。

默认地址是什么?

所有请求都通过 GET 方式发送到同一地址,并添加 api_key 和 action。

https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=...

可以发送哪些请求?

支持号码购买、代码确认、取消、信用查询等7种请求。

action职责响应示例
getBalance查看余额ACCESS_BALANCE:12.50
getPrices&service=telegram&country=gb各服务和国家的价格及剩余号码{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gb购买号码ACCESS_NUMBER:ID:PHONE
getStatus&id=ID查看验证码STATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8号码使用取消(未收到代码时全额退款)ACCESS_CANCEL
setStatus&id=ID&status=3使用同一号码接收额外验证码ACCESS_RETRY_GET
setStatus&id=ID&status=6结束使用ACCESS_ACTIVATION

请求参数

名称必填说明
api_key全部在账户页面生成的 API 密钥
action全部getBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumber服务名称代码(例如:telegram, whatsapp, google)。与服务列表页面的值相同
countrygetNumber国家代码 2 位 (示例: gb, us, id)
idgetStatus, setStatusgetNumber分配的号码ID(以N开头)
statussetStatus8取消,3重新请求验证码,6结束,1准备

响应文本与含义

响应为简洁文本格式。同时显示是否扣除账户余额。

响应含义金额
ACCESS_NUMBER:ID:PHONE已获取号码扣除号码费用
STATUS_WAIT_CODE正在等待验证码保持不变
STATUS_OK:CODE验证码已到支付完成
STATUS_WAIT_RETRY:CODE正在等待额外的验证代码(包括之前的代码)无额外费用
STATUS_CANCEL已取消或时间已结束未收到验证码则已退款
ACCESS_CANCEL已取消全额退款
ACCESS_RETRY_GET正在等待使用同一号码再次接收代码无额外费用
ACCESS_ACTIVATION号码已使用完毕保持不变
NO_BALANCE充值余额后即可立即接收不扣费
NO_NUMBERS当前无法提供该国家号码不扣费
NO_ACTIVATIONS进行中的号码已达 20 个不扣费
EARLY_CANCEL_DENIED已接收验证代码的号码请选择结束(6)而非取消保持不变
BAD_KEYAPI 密钥不正确不扣费
BAD_SERVICE / BAD_COUNTRY服务或国家代码不正确不扣费
NO_ACTIVATION未找到号码 ID保持不变
TOO_MANY_REQUESTS已超过每分钟 300 次不扣费

通过API接收验证码的顺序是什么?

接收号码、输入号码、确认代码、完成的四个步骤。

  1. 1步

    获取号码

    通过getNumber选择所需服务和国家获取号码

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2步

    输入号码

    将购买的号码输入注册页面或程序中。

    +44 7700 900123
  3. 3步

    查看验证码

    每5秒调用一次getStatus,检查验证码是否到达。

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4步

    完成

    输入验证码后请设置状态为6完成验证。若20分钟内未收到代码将自动退款。

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

各语言示例

接收号码、等待代码、完成的全过程。点击选项卡更改语言。

import time, requests

BASE = "https://snssim.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

API常见问题

API提供145个国家1,255个服务的号码,价格与网页相同。

什么是短信验证API?
通过HTTP请求实现虚拟号码购买、验证码获取和订单取消的程序功能。SNSSIM API采用行业标准的handler_api方式。
可以使用在其他 SMS 验证网站上使用的程序吗?
若使用handler_api方式的程序,只需修改基础地址和API密钥即可立即连接
API费用另计吗?
没有区别。API和网页界面使用相同的信用和价格。
最多可以请求多少次?
每个API密钥每分钟最多可请求300次。超过限制将返回TOO_MANY_REQUESTS错误,且不会扣除积分。
通过API购买的电话号码可以退款吗?
是的。若20分钟内未收到代码,API购买的号码也会自动退返至账户余额。
在哪里创建API密钥?
登录后,在账户页面的 API 菜单中生成。密钥仅在生成时显示一次,请立即保存。

生成API密钥后立即连接

注册后充值信用,您可以在账户页面立即生成API密钥。

SMS 验证 API | SNSSIM