文档中心 部门接口 查询部门及其所有下属部门

查询部门及其所有下属部门

1.功能说明

查询部门及其所有下属部门

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/department/getHierarchy

HTTP请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
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"
}
错误返回示例
{
    "code": 1000210001,
    "msg": "timestamp check failed!",
    "data": null
}