AllinSMS
建立帳戶

API 文件

相容 sms-activate 的 handler_api：相同的動作、狀態、國家與服務代碼，另提供驗證碼 Webhook。

handler_api 網址

https://allinsms.com/stubs/handler_api.php

REST API 基礎網址

https://allinsms.com/v1

建立帳戶即可取得 API 金鑰

號碼 (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當前美元餘額。
getNumberservice, country, maxPrice?ACCESS_NUMBER:1042:6281244739021購買號碼。立即扣款，沒收到驗證碼即退款。
getNumberV2service, country, maxPrice?{"activationId":1042,"phoneNumber":"628…","activationCost":"0.7800",…}與 getNumber 相同，以 JSON 回應價格和結束時間。
getStatusidSTATUS_WAIT_CODE · STATUS_OK:48213 · STATUS_WAIT_RETRY:48213 · STATUS_CANCEL每 3 到 5 秒輪詢一次，直到收到驗證碼。
getStatusV2id{"verificationType":0,"sms":{"code":"48213","text":"…"},"call":null}含完整簡訊內容的 JSON 狀態。
getFullSmsidFULL_SMS:Your code is 48213最後一則簡訊的完整內容。
setStatusid, status=1|3|6|8ACCESS_READY · ACCESS_RETRY_GET · ACCESS_ACTIVATION · ACCESS_CANCEL1 就緒、3 再收一組、6 完成、8 取消 (等待時間後、收到驗證碼前)。
getActiveActivations無{"status":"success","activeActivations":[…]}你目前仍有效的號碼。
getPricesservice?, country?{"6":{"tg":{"cost":"0.7800","count":5320}}}各國家與服務的價格和庫存。
getNumbersStatuscountry?{"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" }