选择语言

兼容 sms-activate 的接口

只需更换一个 URL,就能继续使用为 sms-activate 协议打造的机器人和面板。了解支持的操作、ID 格式以及需要注意的差异。

本页内容
  1. 接口地址
  2. 示例
  3. 支持的操作
  4. ID
  5. 需要注意的差异

许多工具使用 sms-activate 协议。SmsGrab 提供兼容接口,只要更换基础 URL 并使用你的 SmsGrab API 密钥,这些工具就能正常工作。

接口地址

文本
https://smsgrab.com/api/stubs/handler_api.php

通过 GET 或 POST 发送 api_key 和 action 以及该操作的参数。密钥也可以通过 Authorization: Bearer 发送。

示例

Bash
curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getBalance"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getNumber&service=tg&country=6"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getStatus&id=100000123"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=setStatus&id=100000123&status=6"
文本
ACCESS_BALANCE:12.34
ACCESS_NUMBER:100000123:6281234567890
STATUS_WAIT_CODE
STATUS_OK:482913
ACCESS_ACTIVATION

支持的操作

操作 作用
getBalance, getBalanceAndCashBack 你的余额
getNumber, getNumberV2 购买号码
setStatus 1 就绪,3 等待下一条短信,6 完成,8 取消并退款
getStatus, getStatusV2 等待中、已收到验证码或已取消
getActiveActivations 仍在使用中的号码
getPrices, getTopCountriesByService, getNumbersStatus 价格和库存
getCountries, getServicesList 国家和服务及其 ID

ID

  • 服务 在协议有对应短代码时使用短代码,例如 wa WhatsApp、tg Telegram、go Google、fb Facebook、ig Instagram 和 ds Discord。我们自己的服务 ID 也可以使用。
  • 国家 在协议有对应数字 ID 时使用数字 ID,例如 0 俄罗斯、6 印度尼西亚、4 菲律宾、22 印度和 187 美国。我们的 ID 和 ISO 代码也可以使用。
  • getCountries 和 getServicesList 会返回完整的最新列表。
  • 激活的 id 是类似 100000123 的数字,REST API 也接受它。

需要注意的差异

  • 金额以美元计,保留两位小数,按你的开发者价格计算。不是卢布。
  • operator 会被忽略;系统会为你选择当前可用的最佳商品。
  • 错误的返回方式与原协议相同,即 HTTP 200 加上 NO_NUMBERS、NO_BALANCE 或 BAD_KEY 等文本。请求过多时会收到带 TOO_MANY_REQUESTS 的 HTTP 429。
  • NO_ACCESS 表示密钥没有 purchase 权限范围、IP 地址不被允许,或已达到每日消费上限。
  • 此接口不支持租用。

其余一切都与 REST API 相同:相同的密钥、限制、价格、退款和 Webhook。

这篇文章对您有帮助吗?

仍需要帮助?

给我们留言。我们会回复每一条消息,通常在几小时内。

或发送邮件至 support@smsgrab.com