API 文件
相容 sms-activate 的 handler_api：相同的動作、狀態、國家與服務代碼，另提供驗證碼 Webhook。
handler_api 網址
https://allinsms.com/stubs/handler_api.php
REST API 基礎網址
https://allinsms.com/v1
號碼 (handler_api)
以 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 | 當前美元餘額。 |
| 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 值
- 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" }