Proxy302 API 文档

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

官方 MCP 服务

Proxy302 团队维护,开源在 GitHub。Cursor、VS Code 点一下就能添加,Claude.ai、ChatGPT 用网页连接器,电脑上什么都不用装。

  • proxy302-mcp (官方) — 让 Claude、ChatGPT、Cursor、VS Code 等 AI 工具直接查用量、取代理、换 IP、查 IP 纯净度,这些工具都不花钱。 GitHub · 添加到 Cursor · 安装到 VS Code
    网页连接器(Claude.ai、ChatGPT): https://mcp.proxy302.com/mcp 在连接器设置里添加这个地址,授权页里粘贴「密钥 ID:密钥」。
    Claude Code(添加后输入 /mcp 登录): claude mcp add --transport http proxy302 https://mcp.proxy302.com/mcp
    密钥放请求头(Claude Code): claude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"
    本地版(Claude Code): claude mcp add proxy302 -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp
    已充值的账号第一次通过 MCP 用成功,送 1 PTC,每个账号一次。

身份与认证

签发 Basic 凭据与查询当前密钥身份。只有密钥本身(p302_ 开头那串)时,直接发 Authorization: Bearer <密钥> 即可。

  • 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 剩下的天数不退款。

  • DELETE /open_api/v3/proxy/token/{token_id} — 删除一个代理连接
  • DELETE /open_api/v3/proxy/tokens — 批量删除(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

流量上限(子账号)

每条连接有自己的账号密码,给它设一个流量上限,就能当子账号分给同事、工具或你的客户,用完就停。只有按流量计费的动态连接能设;用量从设置(或清零)时开始算,在途的流量也算进去,一批连接同时跑也不会超。到上限后 HTTP 代理回 403,SOCKS5 拒绝连接。

  • GET /open_api/v3/proxy/traffic-caps — 列出账户里所有设了上限的连接
  • GET /open_api/v3/proxy/token/{token_id}/traffic-cap — 查看一条连接的上限和已用量
  • POST /open_api/v3/proxy/token/{token_id}/traffic-cap — 设置或修改上限
  • DELETE /open_api/v3/proxy/token/{token_id}/traffic-cap — 取消上限

Proxy302

PROXY302