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
典型流程
- 使用getNumber选择服务与国家,保存返回的ID
- 在应用中输入号码并请求短信验证码
- 每隔5-10秒调用getStatus直至返回STATUS_OK
- 需要新短信?调用setStatus 3后再次getStatus。完成时调用setStatus 6
- 未收到代码?setStatus 8可全额退款取消。若不操作,窗口期结束后将自动退款
错误处理
| 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个激活未完成 |