代理API文檔，訂單和連線信息自動化
SMMProxy開發者API通過HTTPS REST提供餘額查詢、價格查詢、代理訂單及連接信息列表。儀表板API密鑰菜單創建密鑰後，需在Authorization標頭以Bearer形式發送。
開始使用
- 創建帳戶並完成首次充值。API金鑰需在完成至少一次充值的帳戶中生成。
- 在儀表板的API密鑰菜單創建新密鑰。密鑰僅在創建時顯示一次，請立即保存。
- 所有請求需包含Authorization: Bearer金鑰。回應為JSON格式且始終包含ok欄位。
基本地址: https://smmproxy.io/api/v1
curl -H "Authorization: Bearer smpk_YOUR_KEY" https://smmproxy.io/api/v1/balance
GET/api/v1/balance
查詢餘額
響應示例
{ "ok": true, "balance": "48.20", "currency": "USD" }GET/api/v1/products
查詢產品·國家·價格
響應示例
{ "ok": true, "periods": ["1w","2w","1m","2m","3m","6m","9m","12m"],
"products": [{ "product": "isp", "unit": "ip", "countries": [{ "country": "us", "monthly": "1.29" }] }] }POST/api/v1/orders
代理訂單 (從餘額支付)
請求正文
{ "product": "isp", "country": "us", "quantity": 5, "period": "1m" }響應示例
{ "ok": true, "order": { "id": "OR-7K2M-Q8XD4P", "product": "isp", "country": "us",
"quantity": 5, "period": "1m", "total": "6.45", "expires_at": "2026-11-21T09:00:00.000Z" } }GET/api/v1/orders
訂單列表 (最近100筆)
響應示例
{ "ok": true, "orders": [{ "id": "OR-7K2M-Q8XD4P", "status": "active", "total": "6.45" }] }GET/api/v1/proxies?order=OR-7K2M-Q8XD4P
連接資訊列表
響應示例
{ "ok": true, "proxies": [{ "host": "198.51.100.24", "http_port": 10842, "socks5_port": 20842,
"username": "u7kq2m", "password": "Xc81pLq0Zr", "country": "us", "expires_at": "..." }] }訂單金額
| 名稱 | 格式 | 說明 |
|---|---|---|
| product | string | isp, mobile, ipv4, residential |
| country | string | 國家代碼2位小寫字母 (us, gb, de ...) |
| quantity | integer | IP·端口數量，住宅代理按 GB |
| period | string | 1週 2週 1個月 2個月 3個月 6個月 9個月 12個月 (不包括住宅) |
| protocol | string | http或socks5，預設為http（兩個端口均會發放） |
錯誤
| HTTP | error | 含義 |
|---|---|---|
| 401 | unauthorized | 密鑰無效或錯誤。款項不會扣除。 |
| 400 | invalid_request | 請重新確認產品、國家、數量及期限。款項不會扣除。 |
| 402 | insufficient_balance | 餘額不足。請充值後再試。款項不會扣除。 |
| 503 | network_error | 訂單傳送時網絡錯誤。款項不會扣除，稍後可重試。 |
| 429 | rate_limited | 每分鐘可發送最多300次。 |
Python示例
import requests
API = "https://smmproxy.io/api/v1"
H = {"Authorization": "Bearer smpk_YOUR_KEY"}
order = requests.post(f"{API}/orders", headers=H, json={
"product": "isp", "country": "us", "quantity": 5, "period": "1m"}).json()
if order["ok"]:
proxies = requests.get(f"{API}/proxies", headers=H, params={"order": order["order"]["id"]}).json()
for p in proxies["proxies"]:
print(f'{p["host"]}:{p["http_port"]}:{p["username"]}:{p["password"]}')Node.js示例
const API = "https://smmproxy.io/api/v1";
const H = { Authorization: "Bearer smpk_YOUR_KEY", "Content-Type": "application/json" };
const r = await fetch(API + "/orders", { method: "POST", headers: H,
body: JSON.stringify({ product: "mobile", country: "gb", quantity: 1, period: "1m" }) });
const j = await r.json();
console.log(j.ok ? j.order.id : j.error);