查询企业管理员 - ShowCorpAdmin

描述

通过该接口查询企业管理员。

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/usg/dcs/corp/admin/{account}

请求参数

表1 参数说明
参数	是否必须	类型	位置	描述
account	是	String	Path	企业用户账号。如果是账号/密码鉴权方式，是指华为云会议账号如果是App ID鉴权方式，是指第三方User ID
accountType	否	Integer	Query	账号类型。默认0。 0：华为云会议账号。用于账号/密码鉴权方式 1：第三方User ID，用于App ID鉴权方式
X-Access-Token	是	String	Header	授权令牌。获取“执行App ID鉴权”响应的accessToken。
X-Request-Id	否	String	Header	请求requestId，用来标识一路请求，用于问题跟踪定位，建议使用UUID，若不携带，则后台自动生成。
Accept-Language	否	String	Header	语言参数，默认为中文zh-CN，英文为en-US。

状态码

表2 状态码说明
HTTP状态码	描述
200	操作成功。
400	参数异常。
401	未鉴权或鉴权失败。
403	权限受限。
500	服务端异常

响应参数

表3 响应参数
参数	类型	描述
account	String	用户账号。
adminType	Integer	管理员类型。 0：默认管理员 1：普通管理员
country	String	手机号所属的国家。
dept	DeptBasicDTO object	部门基本信息，查询企业级别的管理员时需要显示部门信息。
email	String	邮箱。
id	String	用户id。
name	String	名称。
phone	String	手机号。

表4 DeptBasicDTO 参数说明
参数	类型	描述
corpId	String	企业id。
deptCode	String	部门编码。
deptName	String	部门名称
deptNamePath	String	部门名称路径。
parentDeptCode	String	父部门编码。

请求消息示例

GET /v1/usg/dcs/corp/admin/test006?accountType=0
Connection: keep-alive
X-Access-Token: stbH3o4N83uDQPOcFtScKC9nbqCXt3cIDB1U
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: efd3e53b2d9fa554d11267d5d66ca0bf

{
    "id": "ff8080816a024f05016a4e1c2c570a5d",
    "account": "test006",
    "name": "test006",
    "adminType": 1,
    "email": "******",
    "phone": null,
    "country": null,
    "dept": {
        "deptCode": "1",
        "corpId": "15659",
        "deptName": "wangyue",
        "deptNamePath": "wangyue",
        "parentDeptCode": null
    }
}

错误码

当您使用华为云会议服务端API时，如果遇到“MMC”或者“USG”开头的错误码，请参考华为云API错误中心。

CURL命令示例

curl -k -i -X GET -H 'X-Access-Token: stbH3o4N83uDQPOcFtScKC9nbqCXt3cIDB1U' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/admin/test006?accountType=0

父主题：接口参考

上一篇：添加企业管理员 - AddCorpAdmin

下一篇：批量删除企业管理员 - BatchDeleteCorpAdmins