获取部门列表

企业可通过此接口获取所有部门信息。也可以通过部门id查询该部门下子部门的信息。

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/department/info/list

Query参数:

参数 类型 必填 说明
access_token string 调用接口凭证

Body参数:

{
  "parent_dept_id": 1
}
参数 类型 必填 说明
parent_dept_id long 上级部门id,根节点部门传1

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": [
    {
      "id": 2,
      "name": "广州研发中心",
      "name_en": "rdgz",
      "parent_id": 1,
      "order": 1,
      "path": "/",
      "leaf": false
    },
    {
      "id": 3,
      "name": "邮箱产品部",
      "name_en": "mail",
      "parent_id": 2,
      "order": 2,
      "path": "/",
      "leaf": true
    }
  ]
}

返回说明:

参数 类型 说明
code int 出错返回码,为0表示成功,非0表示调用失败
msg string 返回码描述
data Dept[] 是否操作成功
  id long 是否操作成功
  name string 部门名称,代开发自建应用需要管理员授权才返回;此字段从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回name,返回的name字段使用id代替,后续第三方仅通讯录应用可获取,未返回名称的情况需要通过通讯录展示组件来展示部门名称
  name_en string 英文名称,此字段从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回该字段
  parent_id long 上级部门
  order int 排序
  path string 部门所在路径
  leaf bool 是否子节点

results matching ""

    No results matching ""