所有端点一律返回 HTTP 200,结果写在响应体信封 {code, msg, data} 里:code === 0 才是成功,非 0 时 data 为 null。金额是 PTC 十进制(最多 3 位小数),流量是十进制字节字符串,时间是 Unix 秒。
Proxy302 团队维护,开源在 GitHub。Cursor、VS Code 点一下就能添加,Claude.ai、ChatGPT 用网页连接器,电脑上什么都不用装。
https://mcp.proxy302.com/mcp 在连接器设置里添加这个地址,授权页里粘贴「密钥 ID:密钥」。claude mcp add --transport http proxy302 https://mcp.proxy302.com/mcpclaude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"claude mcp add proxy302 -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp签发 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 定向可选值(优质线路专用)。
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 数组)按 token 绑定来源 IP 认证(每 token 最多 5 个)。
GET /open_api/v3/proxy/token/{token_id}/ip-whitelist — 列出该 token 的白名单 IPPOST /open_api/v3/proxy/token/{token_id}/ip-whitelist — 绑定一个来源 IPDELETE /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