子账户(子用户)
Updated:
提供子用户软件包并管理其列表--无需共享您的主要凭据。
A子用户软件包是从您的主住宅套餐中划分出来的子套餐。您为其分配一定的流量和有效期,子用户在其中管理自己的列表。
用于经销商、团队成员或孤立的客户环境。子软件包中的流量从主配额中保留;删除时,未使用的流量将返回父软件包。
子用户软件包
创建、配置和删除子软件包
阅读
GET/residentsubuser/packages
获取软件包信息
所有子用户软件包的流量限制、过期时间和软件包密钥。
写
POST/residentsubuser/create
创建子用户软件包
从主套餐中为新子套餐预留流量和有效期。
POST/residentsubuser/update
更新软件包
调整流量分配、轮换或有效性。未使用的流量保留在子包中。
DELETE/residentsubuser/delete
删除子用户的软件包
删除子套餐。任何未使用的流量都会返回主关税。
子用户软件包中的列表
与父级住宅列表的操作相同,作用域为子包
阅读
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 列表
所有子账户端点通用
基本 URL
https://proxy-seller.com/personal/api/v1/{YourApiKey}/residentsubuser/认证
URL 路径中的 API 密钥(您的主账户密钥,而非子用户的密钥)
所需参数
大多数端点都需要 package_key - 从
GET/zh-CN/residentsubuser/packages误差模型
业务错误会返回 HTTP 200,其中包含错误[]。
相关
Residential proxysame operations on your main packageOpenSession ID + TTLpin sessions for subuser listsOpenCases (FAQ)common subuser scenariosOpen常见问题
不--命名有误导性。在本应用程序接口中,"子用户 "是指子包:您的主住宅套餐的一部分,有自己的traffic_limit,expired_at,is_active切换和列表。
全部/residentsubuser/...端点采取{YourApiKey}- 你自己的。在规范中,任何地方都没有发布第二个 API 密钥。最终用户收到的凭证是列表级的login/password(由/residentsubuser/list/add) - 这些是代理的连接凭证,而不是管理密钥。
子用户只能看到自己的traffic_limit和consumed.主账户可以看到这两层。
致电update-package随着traffic_limit.充值立即生效。
列表与创建时所在的子软件包绑定。在目标子用户下重新创建列表。