SNSNumber

電話號碼租用API

從您的代碼中租用號碼、讀取接收的SMS、延長及取消。透過HTTPS以JSON格式傳送，使用控制台中的一個API密鑰。

基礎URL
https://snsnumber.com/api/v1
認證
Authorization: Bearer snk_...
速率限制
每分鐘每密鑰300次請求

於控制台的API下創建密鑰。價格以美元為單位，以兩位小數的字符串顯示。時間為ISO 8601格式，UTC時區。

端點

GET/balance您的餘額以美元顯示。
{ "balance": "120.00", "currency": "USD" }
GET/prices?country=us國家、租用期及價格。省略國家以顯示所有。
{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }
POST/rentals租用號碼。請求體：國家及天數。
curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }
GET/rentals?state=active您的租用號碼，最新優先（狀態：有效、過期、已取消）。
{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }
GET/rentals/{id}一個租用號碼及其收件箱。
{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }
POST/rentals/{id}/extend為有效租用號碼增加租期。天數：天。
{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }
POST/rentals/{id}/cancel若在20分鐘內未有收到SMS，可獲全額退款。
{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

錯誤

錯誤會返回HTTP狀態及{ "error": { "code", "message" } }。

狀態代碼含義
401no_key, bad_key缺少或錯誤的API密鑰
402no_balance餘額不足
404not_found找不到租用號碼
409ended, cancel_denied租用已結束，或取消窗口已過
429rate_limited, too_many_active每分鐘300次請求，或20個有效號碼
503network_error稍後再試
電話號碼租用API：租用、收件箱、延長 | SNSNumber