按名称查询所有的部门 - SearchDepartmentByName
描述
企业管理员通过该接口按名称查询所有的部门。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/usg/dcs/member/dept
请求参数
参数 | 是否必须 | 类型 | 位置 | 描述 |
|---|---|---|---|---|
deptName | 是 | String | Query | 部门名称。 长度： 1-128位。 |
X-Access-Token | 是 | String | Header | 授权令牌。获取“执行App ID鉴权”响应的accessToken。 |
X-Request-Id | 否 | String | Header | 请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。 |
Accept-Language | 否 | String | Header | 语言参数，默认为中文zh-CN，英文为en-US。 |
状态码
HTTP状态码 | 描述 |
|---|---|
200 | 操作成功。 |
400 | 参数异常。 |
401 | 未鉴权或鉴权失败。 |
403 | 权限受限。 |
500 | 服务端异常 |
响应参数
参数 | 类型 | 描述 |
|---|---|---|
[数组元素] | Array of QueryDeptResultDTO | 部门列表 |
参数 | 类型 | 描述 |
|---|---|---|
corpId | String | 企业ID。 |
deptCode | String | 部门编码，企业内唯一。 |
deptCodePath | String | 部门编码路径。 |
deptLevel | Integer | 部门层级。 |
deptName | String | 部门名称。 |
deptNamePath | String | 部门名路径。 |
designatedOutDeptCodes | Array of IdMarkDTO 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错误中心。
CURL命令示例
curl -k -i -X GET -H 'X-Access-Token: stbvmKo5lr6vT7QIzKHg4iqicUBcYMb3qlki' https://api.meeting.huaweicloud.com/v1/usg/dcs/member/dept?deptName=wangyue
