接口描述

描述:根据部门 ID 查询企业部门信息,仅企业下具有部门查询权限的用户可查询部门详情。不支持 OAuth2.0 鉴权访问。
调用方式:GET
接口请求域名

https://api.meeting.qq.com/v1/departments/{departmentId}?userid={userid}

输入参数

HTTP 请求头公共参数请参见签名验证章节的 公共参数说明

参数名称 必选 参数类型 参数描述
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 部门人数(不支持递归查询子部门人数)。

示例

输入示例

GET
https://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"
}


下载 查询部门详情.pdf
文章内容是否对您有帮助?
有帮助
无帮助