更新时间:2024-04-29 GMT+08:00

查询终端详情

描述

企业管理员通过该接口查询专业会议终端详情。

如果需要查询IdeaHub、SmartRooms、智慧屏TV详情请使用“查询用户详情”接口。

调试

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

接口原型

表1 接口原型

请求方法

GET

请求地址

/v1/usg/dcs/corp/device/{sn}

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

sn

String

Path

终端SN号,仅可包含数字、字母和下划线。

X-Access-Token

String

Header

授权令牌。获取“执行App ID鉴权”响应的accessToken。

X-Request-Id

String

Header

请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。

Accept-Language

String

Header

语言参数,默认为中文zh-CN,英文为en-US。

状态码

表3 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常

响应参数

表4 响应参数

参数

类型

描述

account

String

硬终端对应的内置账号。

country

String

手机号所属的国家

deptCode

String

部门编码。

deptName

String

部门名称。

deptNamePath

String

部门名称路径。

description

String

终端描述。

email

String

邮箱。

model

String

终端型号,枚举类型。当前支持TE系列硬件终端,具体的终端类型可以通过获取所有终端类型接口查询。

name

String

终端名称。

number

String

终端绑定的号码。

phone

String

手机号。

prjCodeMode

Integer

投影码生成模式。

  • 0:自动

    该模式下根据消息上报的IP地址内部控制复杂度。私网地址配置成简单模式,公网地址配置成复杂模式。

  • 1:简单
  • 2:复杂

sn

String

终端SN号,仅可包含数字、字母和下划线。

status

Integer

终端状态。

  • 0:正常
  • 1:冻结

type

String

终端类型,区分自研和第三方终端。

请求消息示例

GET /v1/usg/dcs/corp/device/asdasfscasd
Connection: keep-alive
X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF
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
Content-Length: 407
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: efa03c0b6cb71b96129744f5a1a8a736 

{
    "name": "test",
    "type": "TE",
    "model": "TE20",
    "sn": "asdasfscasd",
    "account": "df8bce2178294683bb83a4985fef7165",
    "number": "+991118029589",
    "prjCodeMode": 0,
    "deptCode": "1",
    "deptName": "wangyue",
    "deptNamePath": "wangyue",
    "phone": "+86***********",
    "country": "chinaPR",
    "email": "******",
    "description": "test",
    "status": 0
}

错误码

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

CURL命令示例

curl -k -i -X GET -H 'X-Access-Token: stbVbWSIgzfOQ8JnbmPIoBIR3ig8xnVScQOF' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/device/asdasfscasd