飞书 API

获取应用管理员管理范围

GET

/open-apis/contact/v1/user/admin_scope/get

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

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/contact/v1/user/admin_scope/get?employee_id、open_id=' \
--header 'Authorization;'

响应示例

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

请求参数

Query 参数

employee_id、open_id

必需

支持通过 open_id 或者 employee_id 查询，不支持混合两种 ID 进行查询，其中 employee_id 同通讯录 v3 版本中的 user_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

返回响应

🟢200200 Success

application/json

Body

code

integer

必需

返回码，非 0 表示失败

msg

string

返回码的描述

必需

data

object

返回业务数据

必需

is_all

boolean

是否管理所有部门

必需

departments_list

array[string]

必需

管理的部门列表，当 is_all 为 true 时，不返回该字段

修改于 2023-02-02 10:11:54

校验应用管理员

获取应用在企业内的可用范围