API 参考/人员管理/获取成员列表
获取成员列表
更新于: 2026-06-11 19:19:28
获取企业的成员列表,响应数据为分页格式。
users:read
GET /openapi/v1/users
|
参数 |
类型 |
是否必填 |
默认值 |
描述 |
|---|---|---|---|---|
|
|
int |
否 |
|
需返回的页数。 |
|
|
int |
否 |
|
每页返回的成员数量,最多 500 条。 |
|
参数 |
类型 |
描述 |
|---|---|---|
|
|
array |
当前页返回的成员列表。 |
|
|
object |
分页信息,用于控制翻页。 |
items 数组包含以下参数:
|
参数 |
类型 |
描述 |
|---|---|---|
|
|
int64 |
成员的 ID。 |
|
|
string |
成员的名称。 |
|
|
string |
成员的邮箱。 |
|
|
string |
成员的角色:
|
|
|
string |
成员账号的状态:
|
|
|
int64 |
成员加入企业的时间(毫秒时间戳)。 |
pagination 对象包含以下参数:
|
参数 |
类型 |
描述 |
|---|---|---|
|
|
int |
当前页码。 |
|
|
int |
每页条数。 |
|
|
int |
总记录数。 |
|
|
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
}
}
}