GBProxies

Proxy API 文档

REST API 允许您的代码检查价格、读取账户余额和剩余流量、购买流量并获取代理登录信息。通过 HTTPS 传输 JSON 数据,每个账户使用一个 Bearer 密钥,可在控制台的 API 密钥页面生成。

基础 URLhttps://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/orders

错误

每个响应都包含 ok。错误时会添加 error(稳定代码)和 message。任何错误都不会产生费用。

unauthorized401API密钥缺失或错误。
bad_product400未知产品ID。
bad_gb400GB数超出该产品的最小/最大值范围。
funds402余额不足。need_usd字段显示需充值金额。不会扣款。
network503当前无法添加流量。不会产生任何费用,请稍后再试。
rate_limited429每分钟单个密钥超过300次请求。

代理集成指南

Proxy API 文档:购买流量、检查剩余流量、获取代理登录信息