请登录后查看
SearchDevices
分页查询终端
企业管理员通过该接口分页查询专业会议终端信息。
如果需要查询Ideahub、SmartRooms、智慧屏TV请使用分页查询用户接口。
名称 | 类型 | IN | 必选 | 描述 |
---|---|---|---|---|
Accept-Language | string | header | 否 | 语言参数,默认为中文zh-CN,英文为en-US。 |
X-Request-Id | string | header | 否 | 请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。 |
X-Access-Token | string | header | 是 | Access Token。通过 执行App ID鉴权接口返回的accessToken。 |
enableSubDept | boolean | query | 否 | 是否查询子部门。 默认值:true。 |
deptCode | string | query | 否 | 部门编码,默认为根部门。 默认值:1。 |
model | string | query | 否 | 终端型号,枚举类型。当前支持TE系列硬件终端,具体的终端类型可以通过获取所有终端类型接口查询。 |
searchKey | string | query | 否 | 搜索条件。支持名称、SN模糊查询。 |
limit | integer | query | 否 | 查询数量。 默认值:10。 |
offset | integer | query | 否 | 查询偏移量,若超过最大数量,则返回最后一页。 |
操作成功。
名称 | 类型 | 描述 |
---|---|---|
offset | integer | 页面起始页,从0开始。 |
limit | integer | 每页显示的条目数量。 默认值:10。 |
count | integer | 总数量。 |
data | Array of QueryDeviceResultDTO objects | 终端信息列表。 |
名称 | 类型 | 描述 |
---|---|---|
name | string | 终端名称。 |
type | string | 终端类型,区分自研和第三方终端。 |
model | string | 终端型号,枚举类型。当前支持TE系列和部分第三方硬件终端,具体的终端类型可以通过获取所有终端类型接口查询。 |
sn | string | 终端SN号,仅可包含数字、字母和下划线。 |
account | string | 硬终端对应的内置帐号。 |
number | string | 终端绑定的号码。 |
prjCodeMode | integer | 投影码生成模式。
|
deptCode | string | 部门编码。 |
deptName | string | 部门名称。 |
deptNamePath | string | 部门名称路径。 |
phone | string | 手机号。 |
country | string | 手机号所属的国家 。 |
email | string | 邮箱地址。 |
description | string | 终端描述。 |
status | integer | 终端状态。
|
参数异常。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
权限受限。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
"GET https://{endpoint}/v1/usg/dcs/corp/device?offset=0&limit=10&searchKey=&model=&deptCode=1&enableSubDept=true"
操作成功。
{
"offset": 0,
"limit": 10,
"count": 2,
"data": [
{
"name": "938e581b45814d03bd9916753bccd4f9",
"type": "TE",
"model": "TE10",
"sn": "lEDFM1aPsmVv0pOw82HzM8wGN6So4a",
"account": "e27ea4d4b75d4769822fa0978cce99eb",
"number": "+8657174147",
"prjCodeMode": 0,
"deptCode": "1",
"deptName": "根部门",
"deptNamePath": "根部门",
"phone": "+86123456789",
"country": "chinaPR",
"email": "email@huawei.com",
"description": "description",
"status": 0
},
{
"name": "1ce50758dbfe4e3aa3681ee7b3aea00d",
"type": "TE",
"model": "TE10",
"sn": "iOQUx5licRyeaZt8l7NDNcbUgRayzf",
"account": "4e983bf2d90d4cd5830b2a6cff975c21",
"number": "+8657100155",
"prjCodeMode": 0,
"deptCode": "1",
"deptName": "根部门",
"deptNamePath": "根部门",
"phone": "+86123456789",
"country": "chinaPR",
"email": "email@huawei.com",
"description": "description",
"status": 0
}
]
}
参数异常。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.000000003",
"error_msg": "请检查参数是否合法"
}
权限受限。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.000000004",
"error_msg": "Illegal request"
}