获取指定用户的所有父部门列表旧版SDK
更新于 2024-01-11调用本接口查询指定用户的所有上级父部门路径。
例如，员工A的所属部门组织如下图所示。当传入员工A的userid时，返回的结果按顺序依次为其所有父部门的ID，直到根部门，在本示例中为[[456,123,1],[789,1]]。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 是 | 重要 暂不支持新增申请。 | — |
第三方企业应用 | 是 | 重要 暂不支持新增申请。 | — |
第三方个人应用 | 否 | — | — |
基本信息
请求方式：GET
请求地址：https://oapi.dingtalk.com/department/list_parent_depts
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 51985dbcfxxxx | 调用服务端API的应用凭证。
|
userId | String | 否 | manager4220 | 员工的userId。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
department | Number[] | [379661095,1] | 指定员工的部门信息。 |
errmsg | String | ok | 返回码描述。 |
errcode | Number | 0 | 返回码。 |
示例
请求示例（HTTP）
Loading...
请求示例（JAVA SDK）
Loading...
返回示例
Loading...
