TODAY SMS

JSON · HTTPS · Bearer 金鑰

用短訊 API 一次過處理接收驗證碼及發送短訊

TODAY SMS API 是為開發者而設的 API，以一個 API 金鑰、一個餘額，同時使用以一次性號碼接收驗證碼的短訊驗證 API，以及發送短訊至 227 個國家的短訊發送 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=telegram各 App 的國家及價格
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（SMS activation API），另一種是向全球手機發送短訊的短訊發送 API。兩個 API 使用同一地址、同一 API 金鑰及同一餘額，無須另外註冊或另外增值。

短訊驗證 API 怎樣使用？

步驟共有四個。以 GET /apps 選擇 App 代碼，再以 GET /prices?app=代碼 查看國家及價格。以 POST /numbers 購買號碼後會回傳號碼及 id，每隔數秒呼叫 GET /numbers/{id} 確認驗證碼是否已到。收到驗證碼後，以 POST /numbers/{id}/finish 關閉。

號碼會在 20 分鐘內等候短訊，期間同一號碼收到的短訊無須額外費用。收不到短訊時，時限結束後全數款項退回餘額；如未收到任何短訊，購買 120 秒後亦可用 POST /numbers/{id}/cancel 自行取消。需要 App 驗證自動化或大量虛擬號碼 API 時，重複這個流程即可。

短訊發送 API 怎樣使用？

向 POST /messages 傳送收件人清單（to）及內容（text），便會回傳訊息 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 文件註冊並取得金鑰