获取部门列表
企业可通过此接口获取所有部门信息。也可以通过部门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 | 是否子节点 |