API

Proxya API

Proxya API 让程序和 AI 客户端在 API 密钥的权限范围内操作账户:查看余额和订单、购买和续费代理、获取连接凭据、修改代理设置。

更新于 2026年11月22日

API 能做什么#

  • 查看余额、订单、价格、库存和住宅流量。
  • 在密钥的每日限额内使用余额下新订单和续费。
  • 获取代理的用户名、密码和链接,生成住宅代理。
  • 修改代理设置:密码、IP 白名单、系统指纹、移动代理换 IP。

AI 客户端可通过 MCP 服务器 使用同一套 API。

基础地址与格式#

本节所有地址均相对于 https://proxya.co/api/v1。请求和响应均为 JSON。API 密钥放在 Authorization 请求头中。

http
Authorization: Bearer proxya_...

密钥在控制台的 API 密钥 中创建。密钥与权限的说明见 API 密钥与权限。

第一个请求#

密钥从环境变量 PROXYA_API_KEY 读取。该请求返回账户信息和余额。

curl https://proxya.co/api/v1/users/me \
  -H "Authorization: Bearer $PROXYA_API_KEY"

错误#

出错时返回 HTTP 状态码和带 detail 字段的 JSON。状态码为 422 时,detail 是字段列表,逐项给出原因。

json
{"detail": "This API key doesn't have the purchase permission"}
状态码含义
400请求被规则拒绝:已达每日限额、购买请求缺少 Idempotency-Key、价格与当前价格不符。
401缺少密钥,或密钥未知、已撤销、已过期。
402余额不足。
403密钥没有所需权限、该接口不接受密钥、地址不在密钥的 IP 列表中,或账户已被停用。
404订单不存在或属于其他账户。
409该 Idempotency-Key 已用于其他请求,或使用它的第一个请求仍在执行。
422缺少字段或字段值有误。
429请求过多。Retry-After 请求头给出需等待的秒数。
502, 503供应商或服务暂时不可用。重复购买前请先查看订单列表。

频率限制#

  • 每个密钥每分钟 120 个请求,所有接口合计。
  • 同一地址每分钟最多 10 次购买、续费或恢复。
  • 部分操作另有限制,例如移动代理每分钟最多换 IP 12 次。

本节内容#

没有找到答案?

网站在线客服 24 小时回复。通过 Telegram 联系通常最快,提交工单会通过邮件回复。