Proxy302 API 文档

所有端点一律返回 HTTP 200，结果写在响应体信封 {code, msg, data} 里：code === 0 才是成功，非 0 时 data 为 null。金额是 PTC 十进制（最多 3 位小数），流量是十进制字节字符串，时间是 Unix 秒。

身份与认证

签发 Basic 凭据与查询当前密钥身份。

  • GET /open_api/v3/user/users/token — 把密钥编码成 Authorization: Basic 头的值
  • GET /open_api/v3/user/users/me — 当前 API 密钥身份（name / email / uid）

目录查询

购买前查地区代码与静态价格方案。

  • GET /open_api/v3/proxy/area/{area_type} — 按粒度列出地区（country / state / city）
  • GET /open_api/v3/proxy/payway/{payway_name} — 列出静态产品价格方案（payway）

购买（取代理）

四条购买线：静态按流量 / 静态按 IP / 动态按流量 / 动态按区域。参数可放 JSON body 或 query（冲突时 body 优先）。

  • POST /open_api/v3/proxy/api/proxy/static/traffic — 购买静态流量代理
  • POST /open_api/v3/proxy/api/proxy/static/ip — 购买静态 IP（按租期计费）
  • POST /open_api/v3/proxy/api/proxy/dynamic/traffic — 购买动态流量代理
  • POST /open_api/v3/proxy/api/proxy/dynamic/ip/by_area — 按区域购买动态 IP

资产列表

名下代理分页列表：筛选、排序、软删除开关。

  • GET /open_api/v3/proxy/tokens/{generate}/{proxy_type} — 列出代理 token（分页）

流量与用量

日桶消耗、用量图表、流量池余额。

  • GET /open_api/v3/proxy/traffic/consume/log/summary — 按日与池类别汇总消耗
  • GET /open_api/v3/proxy/summary/proxies/{proxy_type}/{statistics_type} — 用量图表序列
  • GET /open_api/v3/proxy/summary/cost/{statistics_type} — 按类目的消费图表（PTC）
  • GET /open_api/v3/proxy/traffic/pool/remaining — 流量池剩余余额

续费

静态 IP 付费续期与自动续费开关。

  • POST /open_api/v3/proxy/token/renew/{token_id} — 续费静态 IP（付费）
  • PUT /open_api/v3/proxy/token/renew/{token_id} — 切换自动续费

ISP 目录

ISP 定向可选值（高级动态线路专用）。

  • GET /open_api/v3/proxy/isp/catalog — 列出 ISP 定向可选值（可按国家过滤）

会话重置

粘滞凭据不换密钥直接换出口 IP（每 token 轮换全部上游会话段，1-100 个）。

  • DELETE /open_api/v3/proxy/sessions — 批量重置粘滞会话（body 传 token_ids 数组）

IP 白名单

按 token 绑定来源 IP 认证（每 token 最多 5 个）。

  • GET /open_api/v3/proxy/token/{token_id}/ip-whitelist — 列出该 token 的白名单 IP
  • POST /open_api/v3/proxy/token/{token_id}/ip-whitelist — 绑定一个来源 IP
  • DELETE /open_api/v3/proxy/token/{token_id}/ip-whitelist/{ip} — 解绑一个来源 IP

Proxy302

PROXY302