Proxy-seller

子账号(子用户)

Updated:

创建子用户包并管理其列表——无需共享您的主账户凭据。

Asubuser 软件包 这是一项从您的主要家庭套餐中拆分出来的子套餐。您为其分配一部分流量和有效期,子用户可在其中自行管理其列表。

此功能适用于转售商、团队成员或独立客户端环境。子包中消耗的流量将从您的主配额中扣除;删除后,未使用的流量将返还给父包。

子用户包

创建、配置和删除子包

阅读

GET/residentsubuser/packages
获取软件包信息
所有带有流量限制、有效期和套餐密钥的子用户套餐。

撰写

POST/residentsubuser/create
创建子用户包
从您的主套餐中为新子套餐预留流量和有效期。
POST/residentsubuser/update
更新包
调整流量分配、轮换或有效期。未使用的流量将保留在子包中。
DELETE/residentsubuser/delete
删除子用户的包
取消子套餐。任何未使用的流量将计入您的主资费套餐。

subuser 包中的列表

与父级住宅列表的操作相同,但范围限定在子包内

阅读

GET/residentsubuser/lists
检索现有的IP列表
子包中的所有列表。可通过 `package_key` 或 `listId` 进行筛选。

撰写

POST/residentsubuser/list/add
创建IP列表
向包含 GEO 过滤器和身份验证方法的子包中添加一个列表。
POST/residentsubuser/list/rename
重命名已创建的列表
在子包内修改列表的显示名称。
POST/residentsubuser/list/rotation
更改轮换顺序
设置置顶、按请求或基于时间的轮播(1–3600 秒)。
DELETE/residentsubuser/list/delete
删除列表
从子包中移除一个列表。活动连接将在约60秒内断开。

特别页面:API-TOOL 列表

所有子账户端点的通用内容

  1. 基础网址

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/residentsubuser/
  2. 身份验证

    URL路径中的API密钥(请使用您的主账号密钥,而非子用户的密钥)

  3. 必填参数

    大多数接口都需要 package_key ——请从

    GET/zh-CN/residentsubuser/packages
  4. 错误模型

    业务错误会返回 HTTP 200 状态码,且 errors[] 字段已填充

相关

Residential proxysame operations on your main packageOpenSession ID + TTLpin sessions for subuser listsOpenCases (FAQ)common subuser scenariosOpen

常见问题解答

不——这种命名容易引起误解。在此 API 中,“子用户”是指子包:您主要住宅套餐中的一部分,其拥有独立的traffic_limit,expired_at,is_active 切换按钮和列表。

全部/residentsubuser/... 端点取{YourApiKey} — 您自己的。规范中任何地方都没有发放第二个 API 密钥。您的最终用户收到的凭据是列表级别的login/password (由/residentsubuser/list/add) —— 这些是代理服务器的连接凭据,而非管理密钥。

不。子用户只能看到自己的traffic_limit 以及consumed。主账户可同时查看这两个层级。

调用update-package 并增加traffic_limit. 充值金额将立即到账。

不。列表与创建它们的子包绑定。请在目标子用户下重新创建该列表。

On this page