获取单个部门信息

该接口用于向通讯录获取单个部门信息。
使用tenant_access_token时，应用需要拥有待查询部门的通讯录授权。如果需要获取根部门信息，则需要拥有全员权限。使用user_access_token时，用户需要有待查询部门的可见性，如果需要获取根部门信息，则要求员工可见所有人。

{ "code": 0, "msg": "success", "data": { "department": { "name": "DemoName", "i18n_name": { "zh_cn": "Demo名称", "ja_jp": "デモ名", "en_us": "Demo Name" }, "parent_department_id": "D067", "department_id": "D096", "open_department_id": "od-4e6ac4d14bcd5071a37a39de902c7141", "leader_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62", "chat_id": "oc_5ad11d72b830411d72b836c20", "order": "100", "unit_ids": [ "custom_unit_id" ], "member_count": 100, "status": { "is_deleted": false } } } }

请求参数

Path 参数

department_id

必需

需要获取的部门ID 示例值："od-4e6ac4d14bcd5071a37a39de902c7141" 数据校验规则：最大长度：64 字符正则校验：^0|[^od][A-Za-z0-9]*

示例值:

od-4e6ac4d14bcd5071a37a39de902c7141

Query 参数

user_id_type

可选

用户 ID 类型示例值："open_id" 可选值有： open_id：用户的 open id union_id：用户的 union id user_id：用户的 user id 默认值：open_id 当值为 user_id，字段权限要求：

示例值:

open_id

department_id_type

可选

此次调用中使用的部门ID的类型示例值："open_department_id" 可选值有： department_id：以自定义department_id来标识部门 open_department_id：以open_department_id来标识部门默认值：open_department_id

示例值:

open_department_id

Header 参数

Authorization

string

必需

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

默认值:

Bearer {{access_token}}

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

department

object

部门信息

必需

获取单个部门信息

请求参数

返回响应