接口描述
描述：根据部门 ID 查询企业部门信息，仅企业下具有部门查询权限的用户可查询部门详情。不支持 OAuth2.0 鉴权访问。
请求方式：GET
自建应用权限点：查看企业部门，管理企业部门。
接口请求域名：
https://api.meeting.qq.com/v1/departments/{departmentId}?userid={userid}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
userid | 是 | String | 接口调用者 userid，必须为企业下具有部门查询权限的用户。 |
department_id | 是 | String | 部门 ID。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
department_full_name | String | 部门全称。 |
department_id | String | 部门 ID。 |
department_name | String | 部门名称。 |
is_main_department | Boolean | 是否是主部门。 |
parent_department_id | String | 上级部门 ID。 |
user_count | Integer | 部门人数（不支持递归查询子部门人数）。 |
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 20000 | 该企业部门信息不存在。 |
400 | 190004 | 参数非法，请对照接口文档检查您的参数。 |
500 | 190443 | 用户无部门操作权限。场景： 1. 用户无编辑部门信息权限 2. 用户无查看部门信息权限 |
示例
输入示例
GEThttps://api.meeting.qq.com/v1/departments/e3ce08567******f05db4de921fc2c2d?userid=meeting4548079
输出示例
{"department_id": "a45edc92********b39e89254c9eb537","department_name": "test-子部门-03","department_full_name": "test-主部门-01/test-子部门-03","is_main_department": false,"user_count": 0,"parent_department_id": "1519a9a********c1f4dd9da464bf856"}
