NATSorganization.member.list列出组织成员

分页返回组织成员及其组织内角色(角色信息回源 permission_service 拼装)。

Request Payload

消息格式:JSON

NameData TypeRequiredDescription
orgIdstringYes组织 ID
pagenumberNo页码,默认 1
pageSizenumberNo每页数量,默认 20,上限 100
keywordstringNo按用户名 / 昵称过滤
type RequestBody = {
  /** 组织 ID */
  orgId: string
  /** 页码,默认 1 */
  page?: number
  /** 每页数量,默认 20,上限 100 */
  pageSize?: number
  /** 按用户名 / 昵称过滤 */
  keyword?: string
}
{
  "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K",
  "page": 1,
  "pageSize": 20
}

Response Payload

回复使用统一信封 {id, code, messages, result},其 result:

NameData TypeRequiredDescription
itemsarrayYes成员列表
totalnumberYes总数
pagenumberYes当前页码
pageSizenumberYes每页数量
type ResponseBody = {
  /** 成员列表 */
  items: Record<string, unknown>[]
  /** 总数 */
  total: number
  /** 当前页码 */
  page: number
  /** 每页数量 */
  pageSize: number
}
{
  "items": [
    {
      "userId": "01JD8SRQ2N5U9W7YR6W0YEM3Z8L",
      "displayName": "王芳",
      "isOwner": false,
      "roles": [
        {
          "roleId": "01JD8SRR3N6V0X8ZS7X1ZFN4A9M",
          "roleName": "开发"
        }
      ],
      "joinedAt": "2026-09-05T06:30:00Z"
    }
  ],
  "total": 12,
  "page": 1,
  "pageSize": 20
}

Response Code

回复使用统一信封 {id, code, messages, result},其 code 字段:

code Meaning Notes
0 成功 列出组织成员

Examples

{ "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K", "page": 1, "pageSize": 20 }
{
  "id": "01JD8SVYCN6P3QM",
  "code": 0,
  "messages": [],
  "result": {
    "items": [
      {
        "userId": "01JD8SRQ2N5U9W7YR6W0YEM3Z8L",
        "displayName": "王芳",
        "isOwner": false,
        "roles": [{ "roleId": "01JD8SRR3N6V0X8ZS7X1ZFN4A9M", "roleName": "开发" }],
        "joinedAt": "2026-09-05T06:30:00Z"
      }
    ],
    "total": 12,
    "page": 1,
    "pageSize": 20
  }
}