部门列表
接口说明: 查询公司部门信息
共三种情况:
departmentId为空时,获取公司所有部门信息
departmentId不为空时
- fetchChild为0时,获取指定部门信息
- fetchChild为1是,获取指定部门下的所有部门信息。返回结果包含指定部门的信息。
请求方式:GET(HTTPS)
请求地址:https://api.xinrenxinshi.com/v3/department/list?departmentId=0c0c857a768b4e1291f0cd9d455cf5e7&sign=ypC5ZR%2Fs92PFHoyicvEEh%2B2%2BnnQ%3D&fetchChild=1×tamp=1574046573214
请求Header::
key | value |
---|---|
access_token | 获取的access_token的实际值 |
参数说明:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
departmentId | string | N | 部门ID |
fetchChild | Integer | N | 是否获取子部门,默认0,0-不包含、1-包含 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
sign | String | Y | 请求参数签名 |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
department | List<DepartmentModel> | Y | 部门列表 |
DepartmentModel
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
adminId | String | Y | 部门负责人员工id |
city | String | Y | 所属城市 |
code | String | Y | 部门编码 |
departmentId | String | Y | 部门ID |
name | String | Y | 部门名称 |
parentId | String | N | 上级部门ID,上级部门为根部门时为空 |
remark | String | Y | 备注 |
type | Integer | Y | 部门类型,0表示部门,1表示事业部,2表示事业群,3表示组,4表示中心,5表示子公司 |
响应示例:
{
"errcode": 0,
"errmsg": "ok",
"detailMsg": null,
"department": [
{
"departmentId": "3c2142ac6c134bd2a44231a835f39f2f",
"name": "测试创建部门1",
"parentId": "",
"code": "109-10092",
"type": 0,
"adminId": "",
"city": "武汉市",
"remark": "测试"
}
]
}