本指南介绍如何创建拥有独立流量上限和列表的子用户套餐——适合分销。
每个请求都使用您账户后台的个人 API 密钥（如何获取 API 密钥）。在以下示例中，请将 YOUR_API_KEY 替换为您自己的密钥。如需用账户余额支付，请使用 paymentId = 1。
步骤 1 — 创建子用户套餐
创建带流量上限、轮换和到期的子用户套餐。从响应中复制 package_key。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/create
请求体
名称 | 类型 | 说明 |
traffic_limit | String | 流量上限（字节）。 |
rotation | Number | 轮换： |
expired_at | String | 套餐到期日期。 |
is_link_date | Boolean | 布尔值——将到期与主套餐关联。 |
响应
{
"status": "success",
"data": {
"package_key": "ab12cd34ef56",
"rotation": 60,
"traffic_limit": "1073741824",
"is_active": true
},
"errors": []
}
步骤 2 — 在套餐中创建 IP 列表
在该套餐中使用 package_key 以及 geo、export 和 rotation 设置创建 IP 列表。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/add
请求体
名称 | 类型 | 说明 |
package_key | String | 套餐密钥（来自套餐信息）。 |
title | String | 列表名称。 |
geo | object | 包含 GEO 数据库中 |
export | object | 对象： |
rotation | Number | 轮换： |
响应
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
步骤 3 — 确认套餐
列出子用户套餐以确认一切设置正确。
接口地址
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": []
}