Skip to content

获取应用管理员的管理范围

该接口用于获取应用管理员的管理范围,即该应用管理员能够管理哪些部门。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/contact/v1/user/admin_scope/get
HTTP MethodGET
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用admin:app.admin:readonly 获取应用管理员 ID、管理范围等信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

请求参数

|参数|类型|必须|说明| |-|-|-|-|-| |employee_id、open_id|string|是|支持通过 open_id 或者 employee_id 查询,不支持混合两种 ID 进行查询,其中 employee_id 同通讯录 v3 版本中的 user_id|

响应

响应体

参数说明
code返回码,非 0 表示失败
msg返回码的描述
data返回业务数据
 ∟is_all是否管理所有部门
 ∟department_list管理的部门列表,当 is_all 为 true 时,不返回该字段

响应示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "is_all":false,
        "departments_list":[
            "od-a140b4eeb892b90a0ab3e616fc2054d6",
            "od-a140b4eeb892b90a0ab3e616fc205477"
        ]
    }
}

内容来源:飞书开放平台 · 自动爬取整理