用户列表
分页检索子客户,支持按登录名、邮箱、备注模糊筛选。分页约定见 通用信息。
鉴权
所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取,并可根据需要重置。详见 通用信息。
接口描述
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 地址 | https://api2.ipmart.io/custom/users |
输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| pageNum | 是 | Int | 页码(从 0 开始) |
| login_name | 否 | String | 用户名(模糊) |
| 否 | String | 邮箱(模糊) | |
| remark | 否 | String | 备注(模糊) |
重要输出参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| status | 是 | Int | 返回码 |
| errorMsg | 否 | String | 错误信息 |
| id | 否 | String | 唯一标识 |
| 否 | String | 邮箱 | |
| login_name | 否 | String | 代理用户名 |
| passwd | 否 | String | 登录密码 |
| remark | 否 | String | 备注 |
| register_time | 否 | String | 注册时间 |
| last_login_time | 否 | String | 最后登录时间 |
| last_login_ip | 否 | String | 最后登录 IP |
| proxyName | 否 | String | 子用户的动态代理账号 |
| proxyPwd | 否 | String | 子用户的动态代理密码 |
| totalElements | 否 | Long | 信息总数(分页) |
| totalPages | 否 | Int | 总页数(分页) |
| number | 否 | Int | 当前页(从 0 开始) |
发送示例
json
{
"login_name": "xiaochong111",
"email": "xy60cn@qq.com",
"remark": "",
"pageNum": 0
}返回示例
成功
json
{
"status": 200,
"data": {
"content": [
{
"access_key_id": "m4DagNWHjHGy12",
"plan_balance": 0,
"last_login_time": "2025-03-05 19:17:56",
"proxyName": "12sj0hQ7ZzScB2",
"proxyPwd": "6X84GX0MxyusLtqA3yc1",
"remark": "",
"register_time": "2024-04-17 17:03:58",
"login_name": "12sj0h11",
"passwd": "12320993sasdkkdi",
"last_login_ip": "163.125.207.84",
"access_key_secret": "pyU9TSie1fe03a2JTRkxWJ9luqn",
"id": "661f908102c953bc555a18",
"email": "123@456.com"
}
],
"totalPages": 1,
"totalElements": 1,
"number": 0,
"size": 20,
"numberOfElements": 1,
"first": true,
"last": true,
"empty": false
}
}