查询部门及子部门¶
功能说明¶
查询部门及其所有下属部门
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/department/getHierarchy
- 生产环境: https://openapi.guanaitong.com/department/getHierarchy
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
-
公有参数
发送请求是必须传入公共参数，详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| enterprise_code | 否 | string | [1,20] | 企业编号(集团必填,企业无需填写) |
| dept_code | 否 | string | [1,50] | 部门编码 |
请求示例¶
POST /department/getHierarchy HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=6007bf4c6efeb798da35b843e4614cff&dept_code=S100&sign=dc2cb643d101d8ae96e857ff4ca24de23bf4f27f&
timestamp=1495094685
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误返回码。 |
| msg | 如果错误，返回错误信息。 |
| data | 如果没有错误，返回部门树，map结构 |
| data.key | 上级部门的部门编号，根部门取值为basic |
| data.value | key取值为basic时，为根部门信息；其他为key的下属部门数组 |
| data.value.dept_code | 部门编码 |
| data.value.name | 部门名称 |
| data.value.parent_code | 上级部门编码 |
| data.value.manager_code | 部门主管工号 |
| data.value.status | 部门状态，1有效、2无效 |
正确返回示例¶
{
"code": 0,
"data": {
"basic":{
"name": "销售部",
"status": 1,
"dept_Code": "A100",
"parent_code": "A001",
"manager_code": "SN123"
},
"A100":[
{
"name": "销售一部",
"status": 1,
"dept_Code": "A110",
"parent_code": "A100",
"manager_code": "SN124"
},
{
"name": "销售二部",
"status": 1,
"dept_Code": "A120",
"parent_code": "A100",
"manager_code": "SN124"
}
]
},
"msg": "OK"
}