Proxy API 文件
REST API 讓您的程式碼可以檢查價格、讀取您的餘額和剩餘流量、購買流量並取得您的 proxy 登入資訊。透過 HTTPS 傳送 JSON，每個帳戶一個 Bearer 金鑰，於控制台的 API 金鑰頁面建立。
基礎 URL
https://gbproxies.cc/api/v1驗證
Authorization: Bearer gbk_...限制每個金鑰每分鐘 300 次請求
端點
GET /products金鑰: 否產品、按量計費的每 GB 價格、連接埠及定位選項。GET /locations?product=residential金鑰: 否單一產品 30 天內可見的國家與獨立 IP 數量。GET /balance金鑰: 是您的美元餘額及各產品已購買、已使用與剩餘的 GB 數。GET /proxy金鑰: 是閘道器主機、您的 proxy 使用者名稱與密碼，以及各產品的連接埠。POST /orders金鑰: 是購買流量：JSON 內容 {"product": "residential", "gb": 50}。從餘額扣款。GET /orders金鑰: 是您最近的 50 筆購買記錄。範例
購買後會回傳訂單 ID、新增的流量和價格。使用 GET /proxy 讀取一次 proxy 登入資訊並重複使用；購買之間不會變更。
{
"ok": true,
"id": "GO-7K2MQX9PLA",
"product": "residential",
"gb": 50,
"price_usd": "30.00",
"state": "added"
}curl https://gbproxies.cc/api/v1/products
curl -H "Authorization: Bearer gbk_YOUR_KEY" https://gbproxies.cc/api/v1/balance
curl -X POST -H "Authorization: Bearer gbk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"product":"residential","gb":50}' https://gbproxies.cc/api/v1/ordersimport requests
H = {"Authorization": "Bearer gbk_YOUR_KEY"}
print(requests.get("https://gbproxies.cc/api/v1/balance", headers=H).json())
r = requests.post("https://gbproxies.cc/api/v1/orders", headers=H, json={"product": "residential", "gb": 50})
print(r.status_code, r.json())const H = { Authorization: "Bearer gbk_YOUR_KEY", "Content-Type": "application/json" };
console.log(await (await fetch("https://gbproxies.cc/api/v1/balance", { headers: H })).json());
const r = await fetch("https://gbproxies.cc/api/v1/orders", { method: "POST", headers: H, body: JSON.stringify({ product: "residential", gb: 50 }) });
console.log(r.status, await r.json());錯誤
每個回應都有 ok。錯誤會新增 error（穩定的代碼）和 message。任何錯誤都不會收取費用。
unauthorized401缺少或錯誤的 API 金鑰。bad_product400未知的產品 ID。bad_gb400GB 數超出產品的最小或最大值。funds402餘額不足。need_usd 顯示需補足的金額。未進行扣款。network503目前無法新增流量。不會收取任何費用，請稍後再試。rate_limited429單一金鑰每分鐘超過 300 次請求。