跳到主要内容

获取部门列表

调用本接口,获取部门列表


权限说明

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

请求

**请求方式:**GET

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

示例如下:

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

其他版本请求地址:

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

专有轻流:http(s)://xxx.xx(自有域名)/openApi/department

2.1 请求头(Header)

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

2.2 参数说明(查询参数):

参数必须说明
deptId部门id,可查询该部门及其所有子部门信息(包括递归)

返回

3.1 返回体

参数必含类型说明
errCodeint错误码,非0表示失败
errMsgstring错误描述
questionRelations关联的设置,这里没用
resultobject返回结果
departmentarray
deptIdstring部门id
deptLeaderarray部门主管的userId
namestring部门名称
optionIdint
parentIdint父部门id
ordinalint同级部门(同个父部门)中的顺序值

3.2 返回体示例

{
"errCode": 0,
"errMsg": null,
"questionRelations": [],
"result": {
"department": [
{
"deptId": 133579,
"deptLeader": [],
"name": "某部门",
"optionId": 133579,
"parentId": null
},
{
"deptId": 149337,
"deptLeader": [],
"name": "1111",
"optionId": 149337,
"parentId": 133579
},
]
}
}

注意事项

1、企微版本公有云工作区,部门名称(name参数)返回值为deptId