基礎 URL https://snsverify.com/api/v1
本頁所有路徑均以此為基礎。金額以美元計算，保留兩位小數，時間為 UTC (ISO 8601 格式)。
兩種格式，一個帳戶
本頁描述使用 JSON 的 REST API。若您的工具已支援常見的短訊激活格式（handler_api.php 帶有 action= 參數），請使用短訊激活 API。兩者共享您的 API 密鑰、價格、未完成的激活及退款。
概覽
SMS 驗證 API 讓您的軟件能為應用程式購買電話號碼，等待驗證 SMS 並讀取代碼，無需打開網站。每個訂單為一次激活：一個服務、一個國家、一個號碼及 20 分鐘的窗口期。未收到代碼的訂單將在窗口期結束時全額退款。
讀取使用 GET，操作使用 POST。POST 主體可為表單字段或 JSON。成功回應為 JSON 物件；錯誤格式統一： {"error":{"code":"...","message":"..."}}.
認證
在控制台的 API 金鑰下創建 API 金鑰。金鑰僅顯示一次；我們僅保存加密副本。請以 bearer token 形式透過 Authorization 標頭發送。無法設置標頭的工具亦可使用 key 參數。
Authorization: Bearer vfk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
創建新金鑰將立即替換舊金鑰。服務、國家及價格端點無需金鑰即可使用。
錯誤訊息
| HTTP | 含義 |
|---|---|
| 400 | 缺少或錯誤字段 (missing_filter, bad_json)。 |
| 401 | 無金鑰或錯誤金鑰 (no_key, bad_key)。 |
| 402 | 餘額不足 (no_balance)。 |
| 404 | 未知服務、國家、訂單或端點。 |
| 409 | 訂單當前無法執行該操作 (has_code, not_ready, too_many_open, no_numbers)。 |
| 429 | 一分鐘內超過 300 次請求 (rate_limited)。 |
快速入門
使用 curl 訂購英國 WhatsApp 號碼，然後每隔幾秒查詢訂單直至收到代碼。
curl -X POST https://snsverify.com/api/v1/orders \ -H "Authorization: Bearer $SNSVERIFY_KEY" \ -d service=whatsapp -d country=gb
Python
import os, time, requests
API = "https://snsverify.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['SNSVERIFY_KEY']}"}
order = requests.post(f"{API}/orders", headers=H,
data={"service": "whatsapp", "country": "gb"}).json()["order"]
print("Use this number:", order["phone"])
while True:
o = requests.get(f"{API}/orders/{order['id']}", headers=H).json()["order"]
if o["code"] or o["status"] in ("refunded", "canceled"):
break
time.sleep(4)
print("Code:", o["code"])Node.js
const API = "https://snsverify.com/api/v1";
const H = { Authorization: `Bearer ${process.env.SNSVERIFY_KEY}` };
const { order } = await fetch(`${API}/orders`, {
method: "POST", headers: H,
body: new URLSearchParams({ service: "telegram", country: "nl" }),
}).then((r) => r.json());
console.log("Use this number:", order.phone);
let o = order;
while (!o.code && !["refunded", "canceled"].includes(o.status)) {
await new Promise((r) => setTimeout(r, 4000));
({ order: o } = await fetch(`${API}/orders/${order.id}`, { headers: H }).then((r) => r.json()));
}
console.log("Code:", o.code);速率限制
每個金鑰每分鐘 300 次請求，每個帳戶最多 20 個開放訂單。每隔 3 至 5 秒查詢訂單已足夠：大多數代碼在一分鐘內到達。
訂單狀態
waiting號碼已開放，尚未收到代碼。received已收到至少一個代碼；在窗口期內可透過 resend 要求發送另一個代碼。finished收到代碼後由您或窗口期結束時關閉。refunded窗口期結束未收到代碼；全額款項已退回您的餘額。canceled您在收到代碼前取消；全額款項已退回您的餘額。
端點
GET/services
列出所有服務代碼及其名稱、類別及最低價格。無需金鑰。
{"services":[{"code":"whatsapp","name":"WhatsApp","category":"social","from":"0.31"}]}GET/countries
列出所有國家代碼 (ISO 小寫) 及其名稱及撥號代碼。無需金鑰。
{"countries":[{"code":"gb","name":"United Kingdom","dial_code":"44"}]}GET/prices?service=whatsapp&country=gb
以美元計價。可過濾服務、國家或兩者。無需金鑰。
{"prices":[{"service":"whatsapp","country":"gb","price":"0.94"}]}GET/balance
您的餘額 (美元)。
{"balance":"25.00","currency":"USD"}POST/orders
購買號碼 (HTTP 201)。返回包含電話號碼及窗口期結束時間的訂單。
主體: service=whatsapp&country=gb
{"order":{"id":"AC-7K2M9QX4PB","service":"whatsapp","country":"gb","phone":"+447700900123","price":"0.94","status":"waiting","code":null,"expires_at":"2026-11-04T12:20:00.000Z"},"window_minutes":20}GET/orders/AC-7K2M9QX4PB
包含狀態及所有收到代碼的訂單。狀態：waiting, received, finished, refunded, canceled。
{"order":{"id":"AC-7K2M9QX4PB","status":"received","code":"482915","sms":"Your WhatsApp code: 482-915"}}GET/orders?status=open
您的開放訂單；status=all 返回最近 100 個。
{"orders":[{"id":"AC-7K2M9QX4PB","status":"waiting"}]}POST/orders/AC-7K2M9QX4PB/resend
在收到首個代碼後，於窗口期內要求同一號碼發送另一個代碼。無需額外費用。
{"order":{"status":"received","waiting_for_resend":true}}POST/orders/AC-7K2M9QX4PB/finish
關閉已收到代碼的訂單。
{"order":{"status":"finished"}}POST/orders/AC-7K2M9QX4PB/cancel
在收到代碼前取消。全額款項將退回您的餘額。
{"order":{"status":"canceled","refunded":"0.94"}}