跳到主要内容

查询单个部门详情

调用本接口,实现获取单个部门的详细信息


权限说明

「超管accessToken」和「权限组accessToken」都可以调用,「权限组accessToken」须具有通讯录权限。

请求

请求方式: GET

请求地址: https://api.qingflow.com/department/:deptId(公有云版本)

请求地址中:deptId为需要替换的变量,根据实际获取值更新,示例如下:

GET https://api.qingflow.com/department/888888

其他版本请求地址:

钉钉版本:https://api.ding.qingflow.com/department/:deptId

专有轻流:http(s)://自有域名/openApi/department/:deptId

2.1 参数说明(路径参数):

参数必须说明
deptId部门 ID

2.2 请求头(Header)

参数必须说明
accessToken调用接口凭证。获取方法请查看“获取OpenAPI accessToken”接口文档

返回

3.1 返回体

参数必含类型说明
errCodeint错误码,非0表示失败
errMsgstring错误描述
questionRelationsarray关联的设置,本接口可忽略
resultarray返回结果
deptIdint部门 ID
namestring部门名
deptLeaderarray部门主管的 userId
parentIdint父部门 ID
ordinalint父部门下顺序值

3.2 返回体示例

{
"errCode": 0,
"errMsg": null,
"questionRelations": [],
"result": {
"deptId": 290144,
"deptLeader": [
"1848991",
"123"
],
"name": "设计部",
"ordinal": 0,
"parentId": 286324
}
}