API
每條線路皆免費，無論時長。沒有企業方案、沒有按席位計價、也沒有銷售電話。
基本 URL
https://api.hushsms.com
驗證
驗證
將您的線路 token 作為 bearer 憑證傳遞。Token 僅限於單一線路，並可從控制台輪換。
curl https://api.hushsms.com/v1/lines \ -H "Authorization: Bearer hs_live_..."
參考
端點
/v1/lines列出您的 token 下的線路。回傳號碼、國家、方案期限與到期日。
/v1/lines佈建一條線路。body 需帶 country、line_type、term 與 pool。回傳加密貨幣發票。
/v1/lines/{id}/messages某條線路的簡訊，最新在前。簡訊內容會在保留期限後刪除。
/v1/lines/{id}/messages傳送一則對外簡訊。每個方案都包含此功能。
/v1/catalog即時國家庫存、各服務相容性與目前價格。不需認證。
/v1/lines/{id}提早釋放一條線路。月租方案不退款；六個月以上按比例退款。
推送
Webhook
每封收到的訊息都會在抵達後一秒內 POST 到您的端點，並以 HMAC-SHA256 簽章。
POST /your-endpoint
X-HushSMS-Signature: sha256=...
{
"event": "message.received",
"line_id": "ln_8fQ2...",
"number": "+44 7700 900123",
"from": "+44 7700 900987",
"body": "Your code is 481920",
"received_at": "2026-08-13T09:41:02Z"
}機器
供 AI 代理使用
機器可讀目錄位於 https://hushsms.com/v1/catalog/。它回傳即時國家庫存、各服務相容性以及目前價格，格式為 JSON，無需驗證。
它回傳即時國家庫存、各服務相容性（包括不適用的服務）、目前價格（含所有乘數）以及資料保留表。不需要金鑰、沒有限流值得一提，CORS 也是開放的。如果您正在建立需要電話號碼的 agent，這是您該讀的 endpoint。
整個網站的純文字摘要位於 /llms.txt，完整語料位於 /llms-full.txt。
目錄作為可呼叫的合約
純文字語料讓目錄可讀，但它不可呼叫：一個讀過所有文字的 agent 仍然不知道請求格式、國家 slug 的列舉，或伺服器忽略哪些欄位，因此它可以描述一個它無法購買的號碼。這就是內容策略止步的地方。
/openapi.json 補上了這個缺口——一份 OpenAPI 3.1 文件，涵蓋三個公開、未經認證的 endpoint（讀取目錄、建立訂單、輪詢訂單），其中 country、term 與 pool 的列舉是從處理器驗證所用的同一份目錄產生的。文件頭也宣告了 rel="service-desc"，因此尋找服務描述的用戶端不用被指引就能找到。
來源
此頁面上的號碼計畫資料 — 國碼、國內號碼長度、冠碼和行動電話範圍 — 取自 ITU-T E.164 系列。庫存、定價和量測的成功率是我們自己的資料，並已標示。
- ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication Union國家通話代碼、國內重要號碼長度、號碼結構
- ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication Union各國號碼計畫、行動電話碼段、冠碼
號碼計畫驗證日期