智慧服务,成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 服务端API参考 > 企业部门管理 > 按名称查询所有的部门 按名称查询所有的部门

入门使用

按名称查询所有的部门

更新时间:2019-11-20

描述

企业管理员通过该接口按名称查询所有的部门。

接口原型

表1 接口原型

请求方法

GET

请求地址

/rest/usg/datacenter/v1/member/dept

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

Authorization

String

Header

授权令牌。将执行鉴权响应的accessToken

进行Base64转码操作

样例:Basic Base64(accessToken)

deptName

String

URL

部门名称。

长度: 1-128位。

响应参数

表3 参数说明

参数

类型

描述

returnCode

String

业务返回码。

returnMessage

String

返回描述。

achievementTime

String

响应产生时间。

requestId

String

请求唯一标识。

data

QueryDeptResultDTO[0..*]

查询部门列表。

请求消息示例

GET /rest/usg/datacenter/v1/member/dept?deptName=user001
Connection: keep-alive
Authorization: Basic UDBRd2RQQW9lOHV2cXBFV0FXejdhbDJ4U3RmelU0aERF
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) 
 

响应消息示例

HTTP/1.1 200 
Date: Thu, 12 Apr 2019 08:44:00 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

{
    "returnCode": "000000000",
    "returnMessage": "Success",
    "achievementTime": "2019-04-12 08:44:00.813",
    "requestId": "db118be10eb687aee5398ba3f589e6d1",
    "data": [{
        "deptCode": "123",
        "deptLevel": 2,
        "deptName": "user001",
        "deptNamePath": "test01#user001",
        "isLeafNode": true,
        "parentDeptCode": "1",
        "deptCodePath": "1#123",
        "note": null,
        "corpId": "42019"
    }]
}
 

CURL命令示例

curl -k -i -X GET -H 'Authorization: Basic VUVwVU82SWFISU0ySWlKaEdoRllRUXk0MUZnbk00Mkpk' https://api.meeting.huaweicloud.com/rest/usg/datacenter/v1/member/dept?deptName=user001