兼容 sms-activate 的接口
只需更换一个 URL,就能继续使用为 sms-activate 协议打造的机器人和面板。了解支持的操作、ID 格式以及需要注意的差异。
许多工具使用 sms-activate 协议。SmsGrab 提供兼容接口,只要更换基础 URL 并使用你的 SmsGrab API 密钥,这些工具就能正常工作。
接口地址
https://smsgrab.com/api/stubs/handler_api.php
通过 GET 或 POST 发送 api_key 和 action 以及该操作的参数。密钥也可以通过 Authorization: Bearer 发送。
示例
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
- 服务 在协议有对应短代码时使用短代码,例如
waWhatsApp、tgTelegram、goGoogle、fbFacebook、igInstagram 和dsDiscord。我们自己的服务 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 地址不被允许,或已达到每日消费上限。- 此接口不支持租用。
这篇文章对您有帮助吗?
谢谢!很高兴能帮到您。