
# 查询部门列表 - GetDepartmentList
#### 功能介绍
查询组织下或某个部门下子部门列表。查询的结果只返回组织或部门下的直属子部门，如需查询最小子部门，需要调用者递归查询。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/departmentList
表1Query参数 
| 参数           | 是否必选 | 参数类型   | 描述                     |
|:---|:---|:---|:---|
| departmentId | 否    | String | 部门ID，当未传值时，只返回根部门ID    |
| keyWord      | 否    | String | 搜索的关键字，可用name作为关键字搜索条件 |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                            |
|:---|:---|:---|:---|
| Authorization | 是    | String | 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token} |
| X-Traceid     | 否    | String | 消息日志跟踪标识（必须58位）                                                                                                                                               |
| language      | 否    | String | 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语                                                                                                            |
| X-User-Id     | 是    | String | 用户id，用于app鉴权                                                                                                                                                  |
| X-Date        | 是    | String | 日期，用于app鉴权                                                                                                                                                    |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数   | 参数类型                                                                           | 描述     |
|:---|:---|:---|
| code | Integer                                                                        | 返回码    |
| msg  | String                                                                         | 返回信息   |
| list | Array of [departmentInfo] objects | 部门信息列表 |
   
 表4departmentInfo 
| 参数       | 参数类型    | 描述              |
|:---|:---|:---|
| code     | Integer | 响应码             |
| msg      | String  | 响应信息            |
| id       | String  | 部门标识            |
| orgId    | String  | OrgID中创建的组织的ID  |
| deptId   | String  | OrgID中创建的部门的ID  |
| parentId | String  | kooDrive中的父部门ID |
| name     | String  | 部门名称            |
| tenantId | String  | 租户ID            |
   
#### 请求示例
查询部门1245640257345455489下子部门列表。
```
GET /koodrive/ose/v1/departmentList?departmentId=1245640257345455489
Authorization:Bearer+10f88**********4791e9ff
```
#### 响应示例
**状态码：200**
返回组织下或某个部门下子部门列表
```
{
  "list" : [ {
    "id" : "1248723349513736065",
    "orgId" : "9190086000001210958",
    "deptId" : "b06f091567064db9a1f6a7dc8d08e8a7",
    "parentId" : "1245640257345455489",
    "name" : "sub11rt",
    "tenantId" : "40086000004871666"
  }, {
    "id" : "1252924812435692416",
    "orgId" : "9190086000001210958",
    "deptId" : "f63c3008420c4c55b3963b6191096e2e",
    "parentId" : "1245640257345455489",
    "name" : "1234666",
    "tenantId" : "40086000004871666"
  } ],
  "code" : 0,
  "msg" : "success"
}
```
#### 状态码
| 状态码 | 描述               |
|:---|:---|
| 200 | 返回组织下或某个部门下子部门列表 |
   
