本指南介绍如何更新子用户套餐、管理其列表或删除它。
每个请求都使用您账户后台的个人 API 密钥（如何获取 API 密钥）。在以下示例中，请将 YOUR_API_KEY 替换为您自己的密钥。如需用账户余额支付，请使用 paymentId = 1。
步骤 1 — 列出子用户套餐
列出子用户套餐，并复制要操作的 package_key。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/packages
响应
{
"status": "success",
"data": [
{ "package_key": "ab12cd34ef56", "traffic_limit": "1073741824", "is_active": true, "expired_at": "d.m.Y" }
],
"errors": []
}
步骤 2 — 更新套餐
更新套餐：更改流量上限、轮换、到期，或用 is_active 开关它。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/update
请求体
名称 | 类型 | 说明 |
package_key | String | 套餐密钥（来自套餐信息）。 |
traffic_limit (可选) | String | 流量上限（字节）。 |
rotation (可选) | Number | 轮换： |
expired_at (可选) | String | 套餐到期日期。 |
is_active (可选) | Boolean | 布尔值—— |
is_link_date (可选) | Boolean | 布尔值——将到期与主套餐关联。 |
响应
{
"status": "success",
"data": {
"package_key": "ab12cd34ef56",
"rotation": 60,
"traffic_limit": "1073741824",
"is_active": true
},
"errors": []
}
步骤 3 — 管理套餐列表
列出套餐中的列表，然后重命名某个列表（id + title + package_key）或按 listId 删除一个。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/lists
响应
{
"status": "success",
"data": [
{ "id": 7788, "title": "Client A", "login": "x1y2z3", "package_key": "ab12cd34ef56" }
],
"errors": []
}
接口地址 — rename
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/rename
名称 | 类型 | 说明 |
id | Number | 列表 id。 |
title | String | 列表的新名称。 |
package_key | String | 套餐密钥（来自套餐信息）。 |
接口地址 — delete list
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/delete
步骤 4 — 或删除整个套餐
通过 package_key 删除整个子用户套餐。 此操作不可撤销。
接口地址
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/delete
请求体
名称 | 类型 | 说明 |
package_key | String | 套餐密钥（来自套餐信息）。 |
响应
{
"status": "success",
"data": { "deleted": true },
"errors": []
}