Proxy API 文档
REST API 允许您的代码检查价格、读取账户余额和剩余流量、购买流量并获取代理登录信息。通过 HTTPS 传输 JSON 数据,每个账户使用一个 Bearer 密钥,可在控制台的 API 密钥页面生成。
基础 URL
https://gbproxies.cc/api/v1认证
Authorization: Bearer gbk_...限制每分钟每个密钥300次请求
端点
GET /products密钥: 否产品清单、按量阶梯价格、端口及定位选项。GET /locations?product=residential密钥: 否单个产品30天内可见的国家及独立IP数量。GET /balance密钥: 是您的美元余额及各产品已购、已用和剩余GB数。GET /proxy密钥: 是网关主机、代理用户名密码及各产品的端口信息。POST /orders密钥: 是购买流量:JSON参数 {"product": "residential", "gb": 50}。从余额扣款。GET /orders密钥: 是最近50笔购买记录。示例
购买后会返回订单 ID、添加的流量和价格。使用 GET /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。任何错误都不会产生费用。
unauthorized401API密钥缺失或错误。bad_product400未知产品ID。bad_gb400GB数超出该产品的最小/最大值范围。funds402余额不足。need_usd字段显示需充值金额。不会扣款。network503当前无法添加流量。不会产生任何费用,请稍后再试。rate_limited429每分钟单个密钥超过300次请求。