公共API

快速开始

Base URL

https://api.gooproxy.com

所有 API 请求均发送至该基础地址。

认证方式

apiKey + sign

每个请求都需要携带您的 apiKey 与 sign 进行认证。

响应格式

JSON

所有接口均返回包含 code、msg 与 data 的 JSON 对象。

以下示例均为占位内容，请将 YOUR_API_KEY 与 YOUR_SIGN 替换为您在 Gooproxy 后台获取的凭证。

认证方式

GET 接口通过 Query 参数携带凭证：

GET — Query

https://api.gooproxy.com/api/account/info?apiKey=YOUR_API_KEY&sign=YOUR_SIGN

POST 接口通过请求头携带凭证：

POST — Header

curl -X POST "https://api.gooproxy.com/api/proxy/buy-residential" \
  -H "apiKey: YOUR_API_KEY" \
  -H "sign: YOUR_SIGN"

apiKey 与 sign 可在 Gooproxy 后台获取。请妥善保管，切勿在公开代码中暴露。

响应格式

请求成功返回 code 200；发生错误时，code 为业务错误码，msg 为错误原因。

{
  "code": 200,
  "msg": "ok",
  "data": {}
}

接口列表

GET/api/account/info获取用户信息

GET/api/account/wallet-balance获取钱包余额

GET/api/account/traffic-balance获取流量余额

GET/api/account/usage-statistics流量使用记录

POST/api/account/create-account创建账号

GET/api/locations/countries获取国家列表

GET/api/locations/states获取州列表

GET/api/locations/cities获取城市列表

GET/api/locations/asn获取 ASN 列表

GET/api/proxy/locationsISP 地区查询

POST/api/proxy/buy-residential购买住宅流量

GET/api/proxy-users/user-list获取代理用户列表

POST/api/proxy-users/create-user创建代理用户

POST/api/proxy-users/update-user更新代理用户

POST/api/proxy-users/delete-user删除代理用户

GET/api/proxy-users/usage-statistics代理用户流量使用记录

GET/api/proxy-users/usage-statistics-hour代理用户流量使用记录（每小时）

GET/api/whitelisted-ips/ip-list获取白名单 IP 列表

POST/api/whitelisted-ips/add-ip添加白名单 IP

POST/api/whitelisted-ips/delete-ip删除白名单 IP

GET/api/proxy/proxy-list获取静态代理列表

GET/api/proxy/expiration-time获取静态过期时间

POST/api/order/order-list订单列表

POST/api/cdk/create创建 CDK

GET/api/cdk/list获取 CDK 列表

POST/api/cdk/revoke撤销 CDK

错误码

API 常见业务错误码。发生错误时，各接口会返回完整的错误信息。

codemessage

200ok

10005Insufficient purchase quantity

10008Insufficient wallet balance

10010IP does not exist

10011Frequent operations, please try again later

10013sign error

10014apiKey error

10020username does not exist

10026The number of whitelists exceeds the limit

10027The IP format is abnormal

快速开始

认证方式

响应格式

接口列表

错误码

准备好开始使用 Gooproxy 了吗？