# 获取父部门信息

该接口用来递归获取部门父部门的信息,并按照由子到父的顺序返回有权限的父部门信息列表。

注意事项:

  • 通过部门ID获取父部门信息

  • 获取+1~+n父部门信息(开放平台会根据使用Token的通讯录的权限过滤)

# 请求

基本
HTTP URL https://hi-gw.weizhipin.com/open-apis/contact/v2/departments/parent
HTTP Method GET
支持的应用类型 自建应用
商店应用
权限要求
开启任一权限即可
获取部门组织架构信息
以应用身份读取通讯录
字段权限要求 该接口返回体中存在下列敏感字段,仅当开启对应的权限后才会返回;如果无需获取这些字段,则不建议申请
获取部门组织架构信息
获取部门基础信息
获取用户 user_id(仅自建应用)

# 请求头

名称 类型 必填 描述
Authorization string tenant_access_token

user_access_token
值格式:"Bearer access_token"
示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560"

# 查询参数

名称 类型 描述
user_id_type string 用户 ID 类型示例值:"open_id"
可选值有:
open_id:用户的 open id
union_id:用户的 union id
user_id:用户的 user id
默认值:open_id
当值为 user_id,字段权限要求:
获取用户 user ID
department_id string 部门ID,根部门的部门ID 为
示例值:"0107"

# 响应

# 响应体

名称 类型 描述
code int 错误码,非 0 表示失败
msg string 错误描述
data - -
 ∟ name string 部门名称
字段权限要求(满足任一)
获取部门基础信息
 ∟ parent_department_id string 父部门的ID
* 创建根部门,该参数值为 “0”
字段权限要求(满足任一)
获取组织架构信息
 ∟ department_id string 本部门的自定义部门ID
字段权限要求(满足任一)
获取部门基础信息
 ∟ leader_user_id string 部门主管用户ID
字段权限要求(满足任一)
获取用户 user_id
 ∟ order int 部门的排序,即部门在其同级部门的展示顺序
 ∟ member_count int 部门下用户的个数
 ∟ status object 部门状态
字段权限要求(满足任一)
获取部门基础信息
 ∟ ∟ is_deleted boolean 是否删除

# 响应体示例

{
  "code": 0,
  "traceId": "_Ao59UOIBLPCeAAu",
  "data": [
    {
      "department_id": "0102",
      "name": "父部门",
      "parent_department_id": "01",
      "leader_user_id": "9279",
      "order": 0,
      "member_count": 1,
      "status": {
        "is_deleted": false
      }
    }
  ],
  "msg": "操作成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
最后更新于 : 8/16/2024, 10:52:48 AM