查询用户组内成员数据

调用该接口查询指定用户组内的成员数据。注意:此接口仅支持查询静态用户组。

请求

基本
请求方式GET
请求地址/openapi/v3/contacts/groups/:group_id/members

请求头

名称类型必填描述
Authorizationstring值格式Bearer {{access_token}}

调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,不同类型的访问凭证可获取的数据范围不同,参考 获取访问凭证

支持鉴权类型:
应用级token:以应用身份调用 API,校验应用的数据访问范围。参考 获取企业内部应用access_token
用户级token:以登录用户身份调用 API,校验用户的可见数据范围。参考 获取登录用户access_token
Content-Typestring固定值:application/json; charset=utf-8

路径参数

名称类型必填描述
group_idstring用户组ID

请求参数

名称类型必填描述
page_sizeuint32每页数量,范围:1-100
page_tokenstring分页token,首次请求可不传

响应

响应体

1{
2 "code": 0,
3 "msg": "success",
4 "data": {
5 "has_more": true,
6 "page_token": "",
7 "account_users": [{
8 "union_id": "string",
9 "name": "string",
10 "join_time": "2023-09-01",
11 "avatar": "头像",
12 "status": "Enable",
13 "account_id": "",
14 "alias_id": "",
15 "employee_number": "458152",
16 "position": "架构师"
17 }]
18 }
19}