查询用户组列表

GET

/contact/v3/group/simplelist

通过该接口可查询企业的用户组列表，如果应用的通讯录权限范围是“全部员工”，则可获取企业全部用户组列表。如果应用的通讯录权限范围不是“全部员工”，则仅可获取通讯录权限范围内的用户组。点击了解通讯录权限范围。

错误码

HTTP状态码	错误码	描述	排查建议
500	40003	internal error	内部错误，请提供 X-Request-Id向客服反馈。联系客服。
400	40011	page size is invalid	无效的分页参数
400	40012	page token is invalid error	page token无效。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/contact/v3/group/simplelist?page_size=50&page_token=AQD9/Rn9eij9Pm39ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JKiSIkdexPw=&type=1' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "grouplist": [
            {
                "id": "g193821",
                "name": "IT 外包组",
                "description": "IT 外包组，需要对该组人群进行细颗粒度权限管控。",
                "member_user_count": 2,
                "member_department_count": 0
            }
        ],
        "page_token": "AQD9/Rn9556539ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JDTJJDDPw=",
        "has_more": true
    }
}

修改于 2025-10-20 09:21:26

查询指定用户组

查询用户所属用户组

查询用户组列表

错误码#

请求参数

返回响应

错误码