API

短信激活API

从您的脚本中购买号码并读取验证码。API使用常见的短信激活格式,因此大多数现有客户端只需更改基本地址和密钥即可使用。

在控制台的API密钥页面创建您的API密钥。密钥仅显示一次。

基础地址与密钥

向基础地址发送带api_key和action的GET或POST请求。密钥在控制台的API密钥页面生成,仅显示一次。

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

服务代码即服务页面上的名称(例如whatsapp、telegram、google)。国家代码为小写ISO代码(us、gb、in)。限制:每个密钥每分钟300次请求。每次激活有20分钟窗口期,与控制台一致。

getBalance

您的美元账户余额

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance
ACCESS_BALANCE:12.50

getServicesList

可购买的服务代码(JSON格式)

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList
{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries

国家代码(ISO小写)与拨号代码(JSON格式)

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries
{"us":{"name":"United States","dial":"1"}}

getPrices

按国家和服务显示美元价格及库存数量。两个筛选条件均为可选。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us
{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

购买激活服务。返回激活ID及带国家代码的号码。

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us
ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

STATUS_WAIT_CODE(尚未收到代码)、STATUS_OK:<code>(成功)、STATUS_WAIT_RETRY:<last code>(已请求新代码)、STATUS_CANCEL(已取消/已退款)

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getStatus&id=AC-7K2M9QX4PB
STATUS_OK:482913

setStatus

status=1 准备就绪(ACCESS_READY)、3 请求新代码(ACCESS_RETRY_GET)、6 完成(ACCESS_ACTIVATION)、8 未收到代码时全额退款取消(ACCESS_CANCEL)

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

典型流程

  1. 使用getNumber选择服务与国家,保存返回的ID
  2. 在应用中输入号码并请求短信验证码
  3. 每隔5-10秒调用getStatus直至返回STATUS_OK
  4. 需要新短信?调用setStatus 3后再次getStatus。完成时调用setStatus 6
  5. 未收到代码?setStatus 8可全额退款取消。若不操作,窗口期结束后将自动退款

错误处理

BAD_KEYAPI密钥缺失或错误
BAD_ACTION未知操作指令
BAD_SERVICE未知服务代码
BAD_COUNTRY该服务在该国家不可用
NO_BALANCE余额不足
NO_NUMBERS当前无可用号码,请稍后再试
NO_ACTIVATION未知激活ID或非您所有
EARLY_CANCEL_DENIED已收到验证码,无法取消激活
TOO_MANY_REQUESTS每分钟请求超过300次
NO_ACTIVATIONS已有20个激活未完成
短信激活API:getNumber、getStatus、setStatus