公共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 了嗎？