查询用户组成员列表

GET

/open-apis/contact/v3/group/{group_id}/member/simplelist

通过该接口可查询某个用户组的成员(目前成员仅支持用户，未来会支持部门)列表，如果应用的通讯录权限范围是“全部员工”，则可查询企业内任何用户组的成员列表。如果应用的通讯录权限范围不是“全部员工”，则仅可查询通讯录权限范围中的用户组的成员列表，点击了解通讯录权限范围。

错误码

HTTP状态码	错误码	描述	排查建议
500	40003	internal error	内部错误，请提供 X-Request-Id向客服反馈。联系客服。
400	40011	page size is invalid	无效的分页参数
400	40012	page token is invalid error	page token无效。
400	42002	invalid group_id	用户组 ID 无效
400	41074	invalid member_type	无效的成员类型
400	41071	en_name length exceed 64 character	英文名长度超过64个字符
400	41072	nickname length exceed 64 character	别名长度超过64个字符
403	42009	no group authority	缺少用户组权限。应用的通讯录权限范围需包含该用户组或为“全部员工”，点击了解更多

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Query 参数

Header 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/open-apis/contact/v3/group/g128187/member/simplelist' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "memberlist": [
            {
                "member_id": "u287xj12",
                "member_type": "user",
                "member_id_type": "user_id"
            }
        ],
        "page_token": "TDRRV9/Rn9eij9Pm39ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JKiJDGexPw=",
        "has_more": true
    }
}

修改于 2023-01-12 07:14:07

移除用户组成员

批量移除用户组成员

查询用户组成员列表

错误码#

请求参数

返回响应

错误码