部门列表

接口说明: 查询公司部门信息

共三种情况:

  • 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&timestamp=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": "测试"
    }
  ]
}
2020 © 企家有道网络技术(北京)有限公司版权所有@京ICP备15035315号 all right reserved,powered by Gitbookupdate by: 2020-12-16 14:23:56

results matching ""

    No results matching ""