TODAY SMS

JSON · HTTPS · Bearer 金鑰

用一個簡訊 API 接收驗證碼和發送簡訊

TODAY SMS API 是給開發者的 API，結合了用一次性號碼接收驗證碼的簡訊驗證 API，以及發送到 227 個國家的簡訊發送 API，只需一個 API 金鑰和一筆餘額。所有請求與回應都是 JSON，價格和退款規則都和網站相同。

查看 API 文件註冊並取得金鑰
today-sms.com/api/v1
$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}
  • 每分鐘 300 次請求
  • 一個金鑰收發簡訊
  • 失敗或未收到時退回餘額
  • 支援12種加密貨幣儲值

簡訊 API 可以做什麼

簡訊驗證 API

選擇 App 和國家、購買號碼，並輪詢狀態取得驗證碼。沒收到簡訊時，時間結束後全額會退回您的餘額。

簡訊發送 API

一次把訊息發送給最多 1,000 位收件人，並取得每位收件人的送達報告。加上預約時間，就會在那時發送。

價格與庫存 API

透過 API 取得各 App 的國家與價格、號碼數，以及各國每則簡訊價格，並直接顯示在您自己的服務中。

一筆餘額

接收和發送使用同一筆餘額。用 USDT 儲值，隨時都能透過 API 查詢。

方法一覽

方法功能
GET/balance查詢餘額
GET/appsApp 清單
GET/prices?app=telegramApp 的國家與價格
POST/numbers購買號碼
GET/numbers/{id}號碼狀態與簡訊
POST/numbers/{id}/cancel取消號碼
POST/numbers/{id}/finish完成號碼
GET/messages/prices各國簡訊價格
POST/messages發送簡訊
GET/messages/{id}發送狀態與送達報告
POST/messages/{id}/cancel取消預約發送

什麼是簡訊 API？

簡訊 API 是讓您的軟體透過 HTTP 請求接收或發送簡訊的連線方式。程式碼會代替人在網頁畫面上點擊，所以自動化註冊測試、發送驗證碼和訂單通知等重複工作，完全不需要人動手。

TODAY SMS API 同時提供兩項功能。一項是用一次性號碼接收 App 驗證碼的簡訊驗證 API（簡訊啟用 API），另一項是發送簡訊到全球手機的簡訊發送 API。兩者使用相同的 URL、相同的 API 金鑰和同一筆餘額，所以不需要另外註冊或儲值。

如何使用簡訊驗證 API？

只要四個步驟。用 GET /apps 選擇 App 代碼，再用 GET /prices?app=CODE 查看國家和價格。用 POST /numbers 購買號碼，取得號碼和它的 id，然後每隔幾秒呼叫 GET /numbers/{id}，確認驗證碼是否送達。拿到驗證碼後，用 POST /numbers/{id}/finish 關閉號碼。

每個號碼會等候簡訊 20 分鐘，這段時間內傳到同一號碼的簡訊不另外收費。沒收到簡訊時，時間結束後全額會退回您的餘額；如果什麼都還沒收到，購買 120 秒後也能用 POST /numbers/{id}/cancel 自行取消。需要 App 驗證自動化或大量虛擬號碼 API 時，只要重複這個流程即可。

如何使用簡訊發送 API？

把收件人清單（to）和訊息內容（text）送到 POST /messages，就會回傳訊息 id、收件人數、則數和總費用。收件人請以含 + 和國碼的國際格式輸入，每次請求最多 1,000 位。要預約發送，請在 at 中填入 UTC 時間。

發送後，用 GET /messages/{id} 查看每位收件人的送達報告。狀態有四種：pending、sent、delivered 和 failed，結果為 failed 的分段金額會加到 refunded 並退回您的餘額。尚未送出的預約發送，可用 POST /messages/{id}/cancel 取消。

發送驗證碼（OTP）也使用相同的方法。每個驗證碼算一則簡訊，沒有額外的驗證費用，您可以用 GET /messages/prices 取得各國每則簡訊價格來估算費用。

選擇平價簡訊 API 時該注意什麼？

請看實際支付的總金額，而不只是價格表上的每則簡訊價格。TODAY SMS 沒有月費，只收取您發送的則數，失敗的分段和沒送達的驗證碼都會退回您的餘額。

接下來，查看金鑰管理和限制。每個帳戶可獲得一個 API 金鑰，並可隨時建立新金鑰，舊金鑰將立即失效。每分鐘允許最多 300 次請求，足以應付大多數自動化需求。最後，查看付款方式。您可以使用包括 USDT、USDC 和 BTC 在內的 12 種加密貨幣進行充值，無需信用卡，因此您可以立即從任何國家開始使用。

要怎麼取得 API 金鑰？

註冊帳號，第一筆儲值入帳後，就能在 API 金鑰頁面建立金鑰。金鑰只會在建立時顯示一次，請保存在安全的地方。每次請求都要放在 Authorization: Bearer 標頭中送出。

如果認為金鑰已經外洩，請在 API 金鑰頁面建立新的金鑰，舊金鑰會立即失效。任何持有您金鑰的人都能用您的餘額購買號碼或發送簡訊，所以請絕對不要把它放在瀏覽器程式碼或公開的儲存庫中。

今天就串接簡訊 API

註冊只需要一個權杖。第一筆儲值入帳後，建立 API 金鑰，貼上文件中的範例，就能送出您的第一個請求。

查看 API 文件註冊並取得金鑰