# 查询应用成员列表

`GET` `/api/member/list`

分页查询当前应用下的所有成员，按加入时间倒序返回，包含成员的用户ID、用户名、昵称和身份主体ID。成员范围由 API Key 归属应用决定，调用方无法跨应用查询。

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| pageNum | integer | 否 | 页码，从1开始，默认1 |
| pageSize | integer | 否 | 每页记录数，取值范围1~100，默认20 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | PageResultMemberVO | 响应数据 |
|     items | array | 数据列表 |
|         userId | integer | 用户ID，成员在平台内的唯一标识 |
|         username | string | 用户名，即成员的登录账号 |
|         nickname | string | 用户昵称 |
|         userPrincipalId | string | 成员对应的点金内核主体ID，成员的会话数据按该主体隔离 |
|         gmtCreate | string | 加入应用的时间 |
|     total | integer | 总记录数 |
|     page | integer | 当前页码，从1开始 |
|     pageSize | integer | 每页大小 |
|     totalPages | integer | - |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |