查询直属子部门
调用该接口查询指定部门的直属子部门信息。
请求
| 基本 | |
|---|---|
| 请求方式 | GET |
| 请求地址 | /openapi/v3/contacts/departments/:department_id/direct_children |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | 值格式:Bearer {{access_token}}调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,不同类型的访问凭证可获取的数据范围不同,参考 获取访问凭证 。 支持鉴权类型: • 应用级token:以应用身份调用 API,校验应用的数据访问范围。参考 获取企业内部应用access_token。• 用户级token:以登录用户身份调用 API,校验用户的可见数据范围。参考 获取登录用户access_token。 |
| Content-Type | string | 是 | 固定值:application/json; charset=utf-8 |
路径参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| department_id | uint64 | 是 | 部门ID |
请求参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| page_size | int | 否 | 页大小,范围:10-100 |
| page_token | string | 否 | 分页token,首次请求可不传 |
响应
响应体
1{2 "code": 0,3 "msg": "success",4 "data": {5 "has_more": true,6 "page_token": "",7 "departments": [{8 "department_id": "string",9 "department_name": ""10 }]11 },12 "trace_id": "ae4bd3d6d939f7790fa354e2402450e0"13}
