API
Proxya API
Proxya API 让程序和 AI 客户端在 API 密钥的权限范围内操作账户:查看余额和订单、购买和续费代理、获取连接凭据、修改代理设置。
更新于 2026年11月22日
API 能做什么#
- 查看余额、订单、价格、库存和住宅流量。
- 在密钥的每日限额内使用余额下新订单和续费。
- 获取代理的用户名、密码和链接,生成住宅代理。
- 修改代理设置:密码、IP 白名单、系统指纹、移动代理换 IP。
AI 客户端可通过 MCP 服务器 使用同一套 API。
基础地址与格式#
本节所有地址均相对于 https://proxya.co/api/v1。请求和响应均为 JSON。API 密钥放在 Authorization 请求头中。
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 是字段列表,逐项给出原因。
{"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 联系通常最快,提交工单会通过邮件回复。