通讯录权限范围变更

GET

/contact/v3/scopes

该接口用于获取应用被授权可访问的通讯录范围，包括可访问的部门列表、用户列表和用户组列表。授权范围为全员时，返回的部门列表为该企业所有的一级部门；否则返回的部门为管理员在设置授权范围时勾选的部门（不包含勾选部门的子部门）。

权限要求（开启任一权限即可）：以应用身份读取通讯录，以应用身份访问通讯录
字段权限要求:该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请.

错误码

HTTP状态码	错误码	描述	排查建议
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 'https://open.feishu.cn/open-apis/contact/v3/scopes?user_id_type&department_id_type&page_token&page_size' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "code": 0,
    "data": {
        "department_ids": [
            "75217143312g9842"
        ],
        "group_ids": [
            "4bgga762"
        ],
        "has_more": true,
        "page_token": "AQD9/Rn9eij9Pm39ED40/e4EuQbBea/ybCE7/PQ1yzQXAVoq7bxTVC%2BI1oJqeoRY",
        "user_ids": [
            "9b2fabg6"
        ]
    },
    "msg": "success"
}

修改于 2025-10-20 09:10:41

通讯录权限范围变更

资源介绍

通讯录权限范围变更

错误码#

请求参数

返回响应

错误码