1.动态代理类型接口
1.1子账户列表详细信息
| 请求方法 | POST |
| 接口路径 | /v1/openApi/openApiDynamicSubList |
1.2生产调用地址
https://thirdapi.onesproxy.com
2.请求头(Headers)
所有请求必须包含以下 HTTP 头:
| 请求头名称 | 类型 | 是否必填 | 参数值 | 说明 |
| Userid | string | 是 | 123456（此为演示值） | 用户唯一标识 |
| Token | string | 是 | 321654（此为演示值） | 认证令牌 |
| Content-Type | string | 是 | application/json | 固定值 |
PS：Userld和token可以登录官网后在支持中心-API集成里面查看，见下图。
2.1Body请求参数（raw-json）
示例：
{
"page":1,// [非必填]页数
"page_size":10,// [非必填]显示数量
"proxy_id": "SC251025b4640e" // [必填]动态代理ID
}注释：查找子账户账号有多少个，以及详细信息。
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
| page | 1 | 否 | number | 页数 |
|
page_size
|
10 | 否 | number | 账号显示数量 |
|
proxy_id
|
SC251027ae905a
|
是 | string | 动态代理ID |
2.2响应示例
示例:
{
"code": 200,
"message": "success",
"data": {
"page": 1, // 当前页
"page_size": 10, // 页大小
"total": 6, // 总记录
"list": [
{
"subaccount_id": 15670, // 子账户Id
"subaccount_name": "su1r545z2r1i", // 子账户名称
"account_type": 1,// 子账号属性标签
"account_type_name": "定额分配",
"gigabyte": 0.5, // 总流量（GB）
"remain_gb": 0.35, // 剩余流量（GB）
"expire_time": 1760682784, // 到期时间戳
"expire_time_str": "2025-10-17 14:33:04", // 到期时间
"is_enable": -1, // 是否可用 ： 1是 -1否
"share_days": 3,//分配天数-到期时间
"status": 2, // 状态：0未启动 1正常 2已过期
"conn_user": "su1r545z2r1i", //连接user
"conn_password": "0e4ei59k", // 连接Pass
"created_at": "2025-10-17 18:16:16" // 创建时间
},
{
"subaccount_id": 182763,// 子账户Id
"subaccount_name": "su921g278e6x",// 子账户名称
"account_type": 2,// 子账号属性标签
"account_type_name": "共享分配",
"gigabyte": "0",// 总流量（GB）0是跟随主账号
"remain_gb": "0",// 剩余流量（GB）0是跟随主账号
"expire_time": 1779984000,// 到期时间戳
"expire_time_str": "2026-05-29 00:00:00",// 到期时间
"is_enable": 1,// 是否可用 ： 1是 -1否
"share_days": 17,//分配天数-到期时间
"status": 1,// 状态：0未启动 1正常 2已过期
"conn_user": "su921g278e6x",//连接user
"conn_password": "f63by81br5",// 连接Pass
"created_at": "2026-05-08 10:21:40"// 创建时间
}
]
}
}注释：请求成功，返回所有的子账号，并显示子账号对应信息。
| 参数名 | 参数值 | 参数类型 | 描述说明 |
|---|---|---|---|
|
code
|
200 | number | 状态码 |
|
message
|
success
|
string | 状态说明 |
|
data
|
- | object | - |
|
data.page
|
1 | number | 页数 |
|
data.page_size
|
10 | number | 页大小 |
|
data.total
|
6 | number | 总数量 |
|
data.list
|
- | object | - |
|
data.list.subaccount_id
|
15670 | string | 账号ID |
|
data.list.subaccount_name
|
su1r545z2r1i
|
string | 账号名 |
|
data.list.account_type
|
1 | number | 子账号属性标签 1定额分配 2共享分配 |
|
data.list.account_type_name
|
定额分配
|
String | 子账号属性 定额分配 共享分配 |
|
data.list.gigabyte
|
0.5 | number | 总流量 |
|
data.list.remain_gb
|
0.35 | number | 剩余流量 |
|
data.list.expire_time
|
1760682784
|
number | 到期时间戳 |
|
data.list.expire_time_str
|
2025-10-17 14:33:04
|
string | 到期时间 |
|
data.list.is_enable
|
-1 | number | 账号是否可用 |
|
data.list.share_days
|
3 | number | 分配天数 |
|
data.list.status
|
2 | number | 账号状态 |
|
data.list.conn_user
|
su1r545z2r1i
|
string | 账号名称 |
|
data.list.conn_password
|
0e4ei59k
|
string | 账号密码 |
|
data.list.created_at
|
2025-10-17 18:16:16
|
string | 创建时间 |