API 文件
與 sms-activate 相容的 handler_api：相同的 action、狀態、國家及服務代碼，另設驗證碼 Webhook。
handler_api 網址
https://allinsms.com/stubs/handler_api.php
REST API 基本網址
https://allinsms.com/v1
號碼 (handler_api)
以 GET 或 POST 傳送 api_key 及 action。國家使用標準數字編號 (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 | 當前美元餘額。 |
| 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",…}} | 國家列表及編號。 |
| getServicesList | 沒有 | {"status":"success","services":[{"code":"tg","name":"Telegram"}]} | 服務代碼及名稱。 |
setStatus 數值
- 1 · 號碼已提交給服務，等待短訊
- 3 · 在同一號碼再索取驗證碼
- 6 · 完成啟用
- 8 · 取消並退款（尚未收到驗證碼）
時間
號碼預設有效 20 分鐘。購買 120 秒後可取消（太早會回傳 EARLY_CANCEL_DENIED）。未收到驗證碼的啟用在結束時會自動退款。速率限制：每個金鑰每分鐘 300 次請求。
錯誤
NO_KEYBAD_KEYNO_ACTIONBAD_ACTIONBAD_SERVICEBAD_COUNTRYNO_NUMBERSNO_BALANCEWRONG_MAX_PRICE:0.7800CHANNELS_LIMITNO_ACTIVATIONBAD_STATUSEARLY_CANCEL_DENIEDTOO_MANY_REQUESTS
Webhook
在「帳戶」設定 Webhook 網址，我們會以 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" }