功能与范围

这些功能使用同一个 ARNPROXY 账户及现有网站流程。各操作页面会说明所需权限、适用产品和验证要求。

账户与余额

读取账户、币种、余额和有效权限。首次符合条件地访问账户页面时会自动创建密钥；管理员限制和验证规则仍然适用。

购买与多国家订单

一个 product_id 下最多可包含 20 个不同的 location_id。每个国家生成独立订单，关联结账按一张发票处理。数量折扣按每个国家自己的数量计算。

已受理不等于已交付

HTTP 201/202 或 state=accepted 可能仅表示受理。使用 purchase_status / residential_purchase_status 跟踪同一次操作，使用 order_delivery 跟踪交付。遵守返回的 poll_after_seconds 和 Retry-After。超时后不要换一个 Idempotency-Key 重新购买。

活跃代理、备注与导出

只可读取自己的活跃代理和订单连接。管理备注，并在拥有相应权限时导出连接信息或 CSV/自定义内容。不会公开其他客户的数据。

续费与自动续费

查询可续费代理和报价，然后使用余额续费。自动续费 API 仅管理现有余额方式；启用设置不会立即扣款，也不会修改银行卡续费设置。

IP 更换申请

获取费用报价、提交申请并跟踪状态。申请仍按现有流程由管理员审核，并非每次调用都会立即分配新 IP。

独立于主凭据的额外登录

可创建、列出、更新和删除额外登录，而不修改交付时的主凭据。随机或自定义模式及长度规则由 options 返回。某些操作会影响整个套餐或订单组。账户的登录页面仅供查看和删除；创建或更新通过 API 完成。

代理授权 IP 管理

请按范围/options 响应允许的能力添加或删除 IP。操作可能影响整个套餐，不要省略范围确认字段。API 删除仅限该账户通过 API 添加并记录的 IP 授权。

住宅代理：新套餐与流量追加

购买 Residential 代理时，客户无需选择用途。新套餐由服务器自动使用与网站订单相同的固定用途；无需发送 purpose_id、subpurpose_id 或 other_purpose。流量充值保留现有套餐的用途。

位置、IP 池与连接列表

查询国家、地区、城市、ISP 选项及 IP 池观测数量。创建列表、修改名称或轮换设置，或删除列表。创建时选择支持的用户名/密码或 IP 验证。池数量可能来自缓存观测，并非每次连接都保证有可用 IP。

会话与目标定位

先创建并验证适用的专用住宅代理列表，再生成 session/TTL 连接字符串。生成字符串不消耗流量；实际使用会消耗流量。

轮换代理

按秒设置适用轮换套餐的 IP 更换间隔。这不是立即更换 IP 的操作；设置按整个套餐范围生效。

两种独立的 IP 白名单

“我的账户 → API”中的白名单决定哪些地址可使用 API 密钥，并在账户页面管理。代理授权 IP 操作决定哪些地址可以连接代理。这两种设置互不影响。

Webhook 与现成客户端

Webhook 为可选功能。您可使用自己的 HTTPS 接收端并验证签名，也可通过状态查询跟踪结果。提供 PHP、Python、Node.js、Java、Go SDK 及 Postman 集合。

Webhook · SDK / Postman

不提供的操作及重要限制

权限由管理员账户设置决定；客户无需另行选择权限。现有管理员限制仍然适用。

使用用途：只需选择子用途