# 按名称查询所有的部门 - SearchDepartmentByName
#### 描述
企业管理员通过该接口按名称查询所有的部门。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=Meeting&api=SearchDepartmentByName)中调试该接口。
#### URI
GET /v1/usg/dcs/member/dept
#### 请求参数
表1参数说明 
| 参数              | 是否必须 | 类型     | 位置     | 描述                                                                                                     |
|:---|:---|:---|:---|:---|
| deptName        | 是    | String | Query  | 部门名称。 长度： 1-128位。                                                  |
| X-Access-Token  | 是    | String | Header | 授权令牌。获取"[执行App ID鉴权](https://support.huaweicloud.com/api-meeting/meeting_21_0311.html)"响应的accessToken。 |
| X-Request-Id    | 否    | String | Header | 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。                                                   |
| Accept-Language | 否    | String | Header | 语言参数，默认为中文zh-CN，英文为en-US。                                                                              |
   
#### 状态码
表2状态码说明 
| HTTP状态码 | 描述        |
|:---|:---|
| 200     | 操作成功。     |
| 400     | 参数异常。     |
| 401     | 未鉴权或鉴权失败。 |
| 403     | 权限受限。     |
| 500     | 服务端异常     |
   
#### 响应参数
表3响应参数 
| 参数       | 类型                                                                   | 描述   |
|:---|:---|:---|
| \[数组元素\] | Array of [QueryDeptResultDTO] | 部门列表 |
   
 表4QueryDeptResultDTO数据结构 
| 参数                     | 类型                                                                                                                                         | 描述                |
|:---|:---|:---|
| corpId                 | String                                                                                                                                     | 企业ID。             |
| deptCode               | String                                                                                                                                     | 部门编码，企业内唯一。       |
| deptCodePath           | String                                                                                                                                     | 部门编码路径。           |
| deptLevel              | Integer                                                                                                                                    | 部门层级。             |
| deptName               | String                                                                                                                                     | 部门名称。             |
| deptNamePath           | String                                                                                                                                     | 部门名路径。            |
| designatedOutDeptCodes | Array of [IdMarkDTO](https://support.huaweicloud.com/api-meeting/meeting_21_0064.html#ZH-CN_TOPIC_0212714418__table16234630202319) objects | 允许访问的部门列表。        |
| inPermission           | String                                                                                                                                     | 其他用户对该部门下用户的访问权限。 |
| isLeafNode             | Boolean                                                                                                                                    | 是否叶子节点。           |
| note                   | String                                                                                                                                     | 备注。               |
| outPermission          | String                                                                                                                                     | 该部门下用户访问权限控制。     |
| parentDeptCode         | String                                                                                                                                     | 父部门编码。            |
| sortLevel              | Integer                                                                                                                                    | 部门排序号。            |
   
#### 请求消息示例
```
GET /v1/usg/dcs/member/dept?deptName=wangyue
Connection: keep-alive
X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
```
#### 响应消息示例
```
HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 539e8b710378987ffc5eb844b5e5c290
[
    {
        "deptCode": "1",
        "deptLevel": 1,
        "deptName": "wangyue",
        "deptNamePath": "wangyue",
        "isLeafNode": false,
        "parentDeptCode": null,
        "deptCodePath": "1",
        "note": null,
        "corpId": "15659",
        "inPermission": "UNLIMITED",
        "outPermission": "UNLIMITED",
        "sortLevel": 10000,
        "designatedOutDeptCodes": []
    }
]
```
#### 错误码
当您使用华为云会议服务端API时，如果遇到"MMC"或者"USG"开头的错误码，请参考[华为云API错误中心](https://apierrorcenter.developer.huaweicloud.com/apierrorcenter/errorcode?product=Meeting)。
#### CURL命令示例
```
curl -k -i -X GET -H 'X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' https://api.meeting.huaweicloud.com/v1/usg/dcs/member/dept?deptName=wangyue
```