部门管理接口

获取部门列表

请求地址:

GET https://hub.juzibot.com/api/v1/department/list?token=***&id=*

参数说明:

参数类型是否必须备注
tokenstring企业级token, 调用接口凭证 获取方式
idnumber部门id. 参考wxDepartmentId

返回示例:

{
  "errcode": 0,
  "errmsg": "ok",
  "departments": [
    {
      "id": 1,
      "name": "句子科技",
      "parentid": 0,
      "order": 0
    },
    {
      "id": 2,
      "name": "研发一部",
      "parentid": 1,
      "order": 99998000
    },
    {
      "id": 3,
      "name": "设计",
      "parentid": 1,
      "order": 99999000
    }
  ]
}

参数说明:

参数类型必定存在备注
errcodenumber返回码
errmsgstring对返回码的文本描述内容
departmentsarray部门列表
departments.idnumber部门id, 参考wxDepartmentId
departments.namestring部门名称
departments.parentidnumber父部门id, 根部门为1. 参考wxDepartmentId
departments.ordernumber在父部门中的次序值,order值越大排序越靠前

获取部门员工

请求地址:

GET https://hub.juzibot.com/api/v1/department/simpleUser?token=***&departmentId=**

参数说明:

参数类型是否必须备注
tokenstring企业级token, 调用接口凭证 获取方式
departmentIdnumber部门id. 参考wxDepartmentId

返回示例:

{
  "errcode": 0,
  "errmsg": "ok",
  "user_list": [
    {
      "userid": "JuXiaoMi",
      "name": "桔小秘",
      "department": [
        18
      ]
    },
    {
      "userid": "JuXiaoMi22",
      "name": "桔小秘22",
      "department": [
        18
      ]
    },
    {
      "userid": "AoSiLu",
      "name": "奥斯陆",
      "department": [
        18
      ]
    }
  ]
}

参数说明:

参数类型必定存在备注
errcodenumber返回码
errmsgstring对返回码的文本描述内容
user_listarray成员列表
data.uidstring组织架构中的员工id, 秒回唯一, 详见uid
user_list.useridstring成员UserID, 参考wxUserId
user_list.namestring成员名称
user_list.departmentarray成员所属部门
最近更新:
Contributors: hamlin.li, wangjingbo, windmemory