兼容 sms-activate 的 handler_api：相同的 action、状态、国家和服务代码，另有验证码 Webhook。
handler_api URL
https://allinsms.com/stubs/handler_api.php
REST API 基础地址
https://allinsms.com/api/v1
通过 GET 或 POST 传入 api_key 和 action。国家使用标准数字 ID (getCountries)，服务使用标准代码 (tg, wa, go …)。除特别说明外，响应均为纯文本。
GET https://allinsms.com/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=tg&country=6| action | 参数 | 响应 | 说明 |
|---|---|---|---|
| getBalance | 无 | ACCESS_BALANCE:12.3400 | 当前余额（USD）。 |
| getNumber | service, country, maxPrice? | ACCESS_NUMBER:1042:6281244739021 | 购买号码。立即扣费，未收到验证码则退款。 |
| getNumberV2 | service, country, maxPrice? | {"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…} | 与 getNumber 相同，返回含价格和结束时间的 JSON。 |
| getStatus | id | STATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL | 每 3 到 5 秒轮询一次，直到收到验证码。 |
| getStatusV2 | id | {"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null} | JSON 格式的状态，含完整短信内容。 |
| getFullSms | id | FULL_SMS:Your code is 48213 | 最后一条短信的完整内容。 |
| setStatus | id, status=1|3|6|8 | ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL | 1 就绪，3 再收一条，6 完成，8 取消（等待时间过后、收到验证码前）。 |
| getActiveActivations | 无 | {"status":"success","activeActivations":[…]} | 你当前仍有效的号码。 |
| getPrices | service?, country? | {"6":{"tg":{"cost":"0.7800","count":5320}}} | 按国家和服务的价格与库存。 |
| getNumbersStatus | country? | {"tg_0":"5320","wa_0":"812",…} | 某个国家各服务的库存。 |
| getCountries | 无 | {"6":{"id":6,"eng":"Indonesia","iso":"id","phoneCode":"62",…}} | 国家列表及 ID。 |
| getServicesList | 无 | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | 服务代码和名称。 |
setStatus 取值
时间规则
号码默认有效 20 分钟。购买 120 秒后可取消（过早取消返回 EARLY_CANCEL_DENIED）。未收到验证码的激活在结束时自动退款。频率限制：每个密钥每分钟 300 次请求。
在“账户”中设置 Webhook URL，我们会以 JSON 格式 POST 每条收到的验证码。如果你的服务器未返回 2xx，将重试两次。
POST https://your-server/webhook
{ "activationId": 1042, "service": "tg", "country": "id", "phone": "6281244739021",
"code": "48213", "text": "Telegram code: 48213 …", "receivedAt": "2026-10-09T03:12:44.000Z" }