产品介绍
产品计费
企业管理
通用设置
用量管理
安全设置
AI 资产管理
个人设置
问题排查
相关协议

获取成员列表

更新于: 2026-06-11 19:19:28

获取企业的成员列表,响应数据为分页格式。

所需权限

users:read

请求方式

GET /openapi/v1/users

请求参数

参数

类型

是否必填

默认值

描述

page

int

1

需返回的页数。

page_size

int

100

每页返回的成员数量,最多 500 条。

响应参数

参数

类型

描述

items

array

当前页返回的成员列表。

pagination

object

分页信息,用于控制翻页。

items 数组包含以下参数:

参数

类型

描述

user_id

int64

成员的 ID。

user_name

string

成员的名称。

email

string

成员的邮箱。

role

string

成员的角色:

  • super_admin:超级管理员
  • admin:管理员
  • member:成员

status

string

成员账号的状态:

  • active:使用中
  • pending:邀请中

join_time

int64

成员加入企业的时间(毫秒时间戳)。

pagination 对象包含以下参数:

参数

类型

描述

page

int

当前页码。

page_size

int

每页条数。

total

int

总记录数。

total_pages

int

总页数。

请求示例

curl -X GET "https://{domain}/openapi/v1/users?page=1&page_size=100" \
  -H "Authorization: Bearer {access_token}"

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "items": [
      {
        "user_id": 123456,
        "user_name": "张三",
        "email": "zhangsan@example.com",
        "role": "admin",
        "status": "active",
        "join_time": 1700000000000
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total": 50,
      "total_pages": 1
    }
  }
}