API
API 接口参考
API 密钥可调用的全部接口及所需权限。地址均相对于 https://proxya.co/api/v1。
更新于 2026年11月22日
列出两种权限时,具备其中任意一种即可。网站的其他接口不接受 API 密钥。
| 方法 | 路径 | 权限 | 用途 |
|---|---|---|---|
| GET | /users/me | read | 账户:邮箱、余额、累计消费 |
| GET | /transactions | read | 余额记录 |
| GET | /pricing/me | read | 账户价格表 |
| GET | /catalog/availability | read | 各地区库存 |
| GET | /catalog/spoofing-profiles | read | 系统指纹配置 |
| GET | /catalog/residential/countries | read | 住宅代理国家 |
| GET | /catalog/residential/cities | read | 某国的住宅代理城市 |
| GET | /catalog/residential/providers | read | 某国的住宅代理运营商 |
| GET | /catalog/residential/pro/countries | read | Residential Pro 国家 |
| GET | /catalog/residential/pro/cities | read | 某国的 Residential Pro 城市 |
| POST | /orders/quote | read, purchase | 新订单报价,不下单 |
| POST | /orders | purchase | 购买 |
| GET | /orders | read | 订单列表 |
| GET | /orders/{id} | read, credentials, purchase | 订单详情、代理与续费价格 |
| POST | /orders/{id}/extend | purchase | 续费 |
| POST | /orders/{id}/restore | purchase | 恢复已终止的订单 |
| PATCH | /orders/{id}/note | manage | 订单备注 |
| POST | /orders/{id}/change-password | manage | 更换代理密码 |
| GET | /orders/{id}/whitelist | read | IP 白名单 |
| POST | /orders/{id}/whitelist | credentials | 向白名单添加 IP |
| DELETE | /orders/{id}/whitelist | manage, credentials | 从白名单移除 IP |
| GET | /orders/{id}/fingerprint | read | 系统指纹状态 |
| POST | /orders/{id}/fingerprint | manage | 开启系统指纹 |
| DELETE | /orders/{id}/fingerprint | manage | 关闭系统指纹 |
| GET | /residential/status | read | 住宅流量余额 |
| POST | /residential/generate | credentials | 生成住宅代理 |
| GET | /residential/ports | read | 住宅代理端口 |
| GET | /residential/entry-hosts | read | 住宅代理入口 |
| GET | /residential/usage | read | 按天和网站统计流量 |
| GET | /mobile/orders/{id} | read | 移动设备状态 |
| GET | /mobile/orders/{id}/ip-history | read | 移动 IP 历史 |
| POST | /mobile/orders/{id}/rotate-ip | manage | 立即更换移动 IP |
| POST | /mobile/orders/{id}/rotation | manage | 自动换 IP 定时 |
| POST | /mobile/orders/{id}/os | manage | 移动设备系统指纹 |
| POST | /mobile/orders/{id}/ip-mode | manage | IPv4 或 IPv6 |
| POST | /mobile/orders/{id}/auth | credentials | 密码或 IP 授权 |
| GET | /mobile/orders/{id}/openvpn | credentials | OpenVPN 配置 |
| GET | /mobile/orders/{id}/wireguard | credentials | WireGuard 配置 |
GET /mobile/locations 无需密钥。密钥只能在控制台中创建、查看和撤销。
没有找到答案?
网站在线客服 24 小时回复。通过 Telegram 联系通常最快,提交工单会通过邮件回复。