子账号(子用户)
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 列表
所有子账户端点的通用内容
基础网址
https://proxy-seller.com/personal/api/v2/{YourApiKey}/residentsubuser/身份验证
URL路径中的API密钥(请使用您的主账号密钥,而非子用户的密钥)
必填参数
大多数接口都需要 package_key ——请从
GET/zh-CN/residentsubuser/packages错误模型
业务错误会返回 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. 充值金额将立即到账。
不。列表与创建它们的子包绑定。请在目标子用户下重新创建该列表。