# 客户可执行的操作 这些功能使用同一个 ARNPROXY 账户及现有网站流程。各操作页面会说明所需权限、适用产品和验证要求。 ## 账户与余额 读取账户、币种、余额和有效权限。首次符合条件地访问账户页面时会自动创建密钥；管理员限制和验证规则仍然适用。 - [权限与功能](https://docs.arnproxy.com/zh/api-v1/account/capabilities) - [账户与币种](https://docs.arnproxy.com/zh/api-v1/account/details) - [账户余额](https://docs.arnproxy.com/zh/api-v1/account/balance) ## 购买与多国家订单 一个 product_id 下最多可包含 20 个不同的 location_id。每个国家生成独立订单，关联结账按一张发票处理。数量折扣按每个国家自己的数量计算。 - [产品列表](https://docs.arnproxy.com/zh/api-v1/products) - [位置与租期](https://docs.arnproxy.com/zh/api-v1/catalog) - [订单报价](https://docs.arnproxy.com/zh/api-v1/quote) - [余额购买](https://docs.arnproxy.com/zh/api-v1/orders/create) - [查询购买状态](https://docs.arnproxy.com/zh/api-v1/orders/create/status) ## 已受理不等于已交付 HTTP 201/202 或 state=accepted 可能仅表示受理。使用 purchase_status / residential_purchase_status 跟踪同一次操作，使用 order_delivery 跟踪交付。遵守返回的 poll_after_seconds 和 Retry-After。超时后不要换一个 Idempotency-Key 重新购买。 - [订单列表](https://docs.arnproxy.com/zh/api-v1/orders/list) - [订单详情](https://docs.arnproxy.com/zh/api-v1/orders/details) - [交付状态](https://docs.arnproxy.com/zh/api-v1/orders/delivery) - [订单代理](https://docs.arnproxy.com/zh/api-v1/orders/proxies) ## 活跃代理、备注与导出 只可读取自己的活跃代理和订单连接。管理备注，并在拥有相应权限时导出连接信息或 CSV/自定义内容。不会公开其他客户的数据。 - [读取代理备注](https://docs.arnproxy.com/zh/api-v1/proxies/note) - [保存代理备注](https://docs.arnproxy.com/zh/api-v1/proxies/note/update) - [活跃代理](https://docs.arnproxy.com/zh/api-v1/proxies/list) - [代理详情](https://docs.arnproxy.com/zh/api-v1/proxies/details) - [导出连接](https://docs.arnproxy.com/zh/api-v1/proxies/export) - [代理可用操作](https://docs.arnproxy.com/zh/api-v1/proxies/actions) ## 续费与自动续费 查询可续费代理和报价，然后使用余额续费。自动续费 API 仅管理现有余额方式；启用设置不会立即扣款，也不会修改银行卡续费设置。 - [自动续期设置](https://docs.arnproxy.com/zh/api-v1/auto-renewal) - [余额自动续期选项](https://docs.arnproxy.com/zh/api-v1/auto-renewal/options) - [自动续期价格](https://docs.arnproxy.com/zh/api-v1/auto-renewal/quote) - [开启自动续期](https://docs.arnproxy.com/zh/api-v1/auto-renewal/enable) - [关闭自动续期](https://docs.arnproxy.com/zh/api-v1/auto-renewal/disable) - [查询设置操作](https://docs.arnproxy.com/zh/api-v1/auto-renewal/status) - [续期选项](https://docs.arnproxy.com/zh/api-v1/renewals/options) - [续期报价](https://docs.arnproxy.com/zh/api-v1/renewals/quote) - [余额续期](https://docs.arnproxy.com/zh/api-v1/renewals/create) - [续期状态](https://docs.arnproxy.com/zh/api-v1/renewals/status) ## IP 更换申请 获取费用报价、提交申请并跟踪状态。申请仍按现有流程由管理员审核，并非每次调用都会立即分配新 IP。 - [更换费用报价](https://docs.arnproxy.com/zh/api-v1/replacements/quote) - [提交更换申请](https://docs.arnproxy.com/zh/api-v1/replacements/create) - [申请提交状态](https://docs.arnproxy.com/zh/api-v1/replacements/status) - [更换申请列表](https://docs.arnproxy.com/zh/api-v1/replacements) ## 独立于主凭据的额外登录 可创建、列出、更新和删除额外登录，而不修改交付时的主凭据。随机或自定义模式及长度规则由 options 返回。某些操作会影响整个套餐或订单组。账户的登录页面仅供查看和删除；创建或更新通过 API 完成。 - [登录替换范围与规则](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/replace/options) - [替换额外登录](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/replace) - [查询登录替换状态](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/replace/status) - [继续未发送的替换步骤](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/replace/resume) - [登录范围与选项](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/options) - [创建额外登录](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/create) - [查看额外登录](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/details) - [删除额外登录](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/delete) - [查询登录操作](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/status) - [继续未发送的登录步骤](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/resume) - [额外登录列表](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins) - [登录与清理历史](https://docs.arnproxy.com/zh/api-v1/proxies/extra-logins/history) ## 代理授权 IP 管理 请按范围/options 响应允许的能力添加或删除 IP。操作可能影响整个套餐，不要省略范围确认字段。API 删除仅限该账户通过 API 添加并记录的 IP 授权。 - [验证访问范围](https://docs.arnproxy.com/zh/api-v1/proxies/access) - [添加授权 IP](https://docs.arnproxy.com/zh/api-v1/proxies/authorized-ips/add) - [移除自己添加的 IP](https://docs.arnproxy.com/zh/api-v1/proxies/authorized-ips/remove) - [查询访问操作](https://docs.arnproxy.com/zh/api-v1/proxies/access/status) - [继续未发送的 IP 步骤](https://docs.arnproxy.com/zh/api-v1/proxies/access/resume) - [主凭据更改 — 已禁用](https://docs.arnproxy.com/zh/api-v1/proxies/primary-credentials/change) · HTTP 403 ## 住宅代理：新套餐与流量追加 购买 Residential 代理时，客户无需选择用途。新套餐由服务器自动使用与网站订单相同的固定用途；无需发送 purpose_id、subpurpose_id 或 other_purpose。流量充值保留现有套餐的用途。 - [住宅代理套餐与价格](https://docs.arnproxy.com/zh/api-v1/residential/catalog) - [套餐与流量充值报价](https://docs.arnproxy.com/zh/api-v1/residential/quote) - [余额购买住宅代理](https://docs.arnproxy.com/zh/api-v1/residential/orders/create) - [住宅代理交付状态](https://docs.arnproxy.com/zh/api-v1/residential/orders/status) ## 位置、IP 池与连接列表 查询国家、地区、城市、ISP 选项及 IP 池观测数量。创建列表、修改名称或轮换设置，或删除列表。创建时选择支持的用户名/密码或 IP 验证。池数量可能来自缓存观测，并非每次连接都保证有可用 IP。 - [住宅代理位置](https://docs.arnproxy.com/zh/api-v1/residential/locations) - [每小时流量历史](https://docs.arnproxy.com/zh/api-v1/residential/traffic) - [导出连接列表](https://docs.arnproxy.com/zh/api-v1/residential/export) - [自己的住宅代理套餐](https://docs.arnproxy.com/zh/api-v1/residential/packages) - [住宅代理套餐详情](https://docs.arnproxy.com/zh/api-v1/residential/packages/details) - [连接列表](https://docs.arnproxy.com/zh/api-v1/residential/lists) - [连接列表详情](https://docs.arnproxy.com/zh/api-v1/residential/lists/details) - [创建与删除范围](https://docs.arnproxy.com/zh/api-v1/residential/lists/options) - [创建连接列表](https://docs.arnproxy.com/zh/api-v1/residential/lists/create) - [删除连接列表](https://docs.arnproxy.com/zh/api-v1/residential/lists/delete) - [查询列表操作](https://docs.arnproxy.com/zh/api-v1/residential/lists/action-status) - [验证列表设置](https://docs.arnproxy.com/zh/api-v1/residential/lists/check) - [刷新套餐快照](https://docs.arnproxy.com/zh/api-v1/residential/packages/refresh) - [重命名连接列表](https://docs.arnproxy.com/zh/api-v1/residential/lists/rename) - [更改列表轮换](https://docs.arnproxy.com/zh/api-v1/residential/lists/rotation) - [查询已保存的列表操作](https://docs.arnproxy.com/zh/api-v1/residential/lists/status) ## 会话与目标定位 先创建并验证适用的专用住宅代理列表，再生成 session/TTL 连接字符串。生成字符串不消耗流量；实际使用会消耗流量。 - [会话列表选项](https://docs.arnproxy.com/zh/api-v1/residential/sessions/options) - [创建独立会话列表](https://docs.arnproxy.com/zh/api-v1/residential/sessions/create) - [生成定向会话连接](https://docs.arnproxy.com/zh/api-v1/residential/sessions/export) - [ISP 标识符](https://docs.arnproxy.com/zh/api-v1/residential/isp-codes) ## 轮换代理 按秒设置适用轮换套餐的 IP 更换间隔。这不是立即更换 IP 的操作；设置按整个套餐范围生效。 - [轮换范围与设置](https://docs.arnproxy.com/zh/api-v1/rotating/options) - [更改轮换间隔](https://docs.arnproxy.com/zh/api-v1/rotating/rotation) - [查询轮换操作](https://docs.arnproxy.com/zh/api-v1/rotating/status) ## 两种独立的 IP 白名单 “我的账户 → API”中的白名单决定哪些地址可使用 API 密钥，并在账户页面管理。代理授权 IP 操作决定哪些地址可以连接代理。这两种设置互不影响。 ## Webhook 与现成客户端 Webhook 为可选功能。您可使用自己的 HTTPS 接收端并验证签名，也可通过状态查询跟踪结果。提供 PHP、Python、Node.js、Java、Go SDK 及 Postman 集合。 ## 不提供的操作及重要限制 不提供银行卡或银行转账充值 API；请在网站充值。客户 API 无法修改或删除交付时的主凭据。IP 更换仍需按现有流程由管理员审核。删除住宅代理连接列表不会删除流量套餐。 权限由管理员账户设置决定；客户无需另行选择权限。现有管理员限制仍然适用。