Proxy API 文件

REST API 讓您的程式碼可以檢查價格、讀取您的信用額度和剩餘 GB、購買流量並獲取您的 proxy 登入資訊。透過 HTTPS 傳送 JSON，每個帳戶一個 Bearer 金鑰，在控制台的 API 金鑰頁面生成。

基礎 URLhttps://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、增加的 GB 和價格。使用 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/orders

import 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 個請求。

Proxy 整合指南