cheapmobileproxy

行動代理開發者API

餘額、產品、訂單、代理和IP變更均可透過REST API處理。您可以在工具和腳本中執行控制台的所有操作。

基本連線資訊與驗證

https://cheapmobileproxy.com/api/v1
Authorization: Bearer YOUR_API_KEY

GET/balance餘額

返回當前可用餘額（美元）。

curl https://cheapmobileproxy.com/api/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY"
{ "ok": true, "balance": "125.40", "currency": "USD" }

GET/products產品與價格

提供各產品銷售國家、各國可選週期與單個代理價格，以及旋轉行動代理的每GB價格。

curl https://cheapmobileproxy.com/api/v1/products \
  -H "Authorization: Bearer YOUR_API_KEY"
{ "ok": true, "currency": "USD", "products": [ { "id": "dedicated", "unit": "proxy", "countries": [ { "country": "us", "periods": [ { "period": "1m", "days": 30, "price": "83.40" } ] } ] }, { "id": "rotating", "unit": "gb", "price_per_gb": "3.59" } ] }

POST/orders購買

使用餘額購買。固定行動需提供product、country、period、quantity(1~100)，輪換行動需提供product、gb(1~1000)、country(選填，預設any)。

curl -X POST https://cheapmobileproxy.com/api/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "product": "dedicated", "country": "us", "period": "1m", "quantity": 2 }'
{ "ok": true, "order": "P-7K2M-Q9XD-4HTA", "charged": "166.80", "balance": "58.60" }

GET/orders訂單列表

返回訂單代碼、產品、國家、期間、數量、金額、狀態和到期日。

curl https://cheapmobileproxy.com/api/v1/orders \
  -H "Authorization: Bearer YOUR_API_KEY"
{ "ok": true, "orders": [ { "code": "P-7K2M-Q9XD-4HTA", "product": "dedicated", "country": "us", "period": "1m", "quantity": 2, "status": "ACTIVE" } ] }

GET/proxies代理列表

返回正在使用的代理的主機、HTTP/SOCKS5端口、用戶名、密碼、當前IP和IP更改連結。

curl https://cheapmobileproxy.com/api/v1/proxies \
  -H "Authorization: Bearer YOUR_API_KEY"
{ "ok": true, "proxies": [ { "id": "pxk3m9q2wt7a", "country": "us", "host": "198.51.100.24", "http_port": 20418, "socks5_port": 30418, "username": "cmpk3m9q2wt", "password": "...", "ip": "203.0.113.57", "ip_change_url": "https://cheapmobileproxy.com/api/rotate/..." } ] }

POST/proxies/{id}/rotate更換IP

固定行動代理的IP可以更換。每個代理每10秒可更換一次。

curl -X POST https://cheapmobileproxy.com/api/v1/proxies/pxk3m9q2wt7a/rotate \
  -H "Authorization: Bearer YOUR_API_KEY"
{ "ok": true, "ip": "203.0.113.91", "changed_at": "2026-10-23T09:30:00.000Z" }

錯誤回應

HTTPcode說明
401auth沒有API金鑰或金鑰不正確
402balance餘額不足（不會扣款）
400bad_country, bad_period, bad_qty, bad_gb請求值與商品不符（款項未扣除）
429rate, too_fast每分鐘300次請求，IP更換間隔最短10秒
503network網路錯誤，請稍後再試（不會扣款）

建立API金鑰

首次儲值到帳後，請至控制台API頁面建立API金鑰。每個請求都需攜帶金鑰，必要時可在控制台更換新金鑰。

適用情境

  • 確認餘額
  • 查看產品、國家、週期與價格列表
  • 下單與訂單狀態查詢
  • 查看我的代理清單與連線資訊
  • 固定線路IP變更（每10秒一次）

訂購與付款

API訂單也從與控制台相同的餘額中支付。固定線路可一次訂購1至100個，旋轉移動代理則以GB為單位訂購。