获取设备详细信息
接口功能
根据 deviceId 获取该设备的详细信息。
请求地址
https://open.qly.cmviot.cn/v3/open/api/device/info请求方式
POST,需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| deviceId | String | Y | 设备 ID,查询多个 id 时以逗号拼接 |
请求示例
{"deviceId":"xxxxS_d8gh390"}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| resultCode | String | 响应码 | 参考响应码定义 |
| resultMsg | String | 响应描述 | |
| data | List | 响应数据 |
data 数据模型
| 名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| appId | String | 开放应用 appiD | |
| deviceId | String | 设备 id | |
| deviceName | String | 设备名称 | |
| deviceImei | String | 设备 imei | |
| deviceSwitch | int | 设备开关状态 | 0:关,1:开 |
| deviceStatus | int | 设备在离线状态 | 0:离线,1:在线 |
| createTime | long | 创建时间 | 13 位毫秒时间戳 |
| modifyTime | long | 修改时间 | 13 位毫秒时间戳 |
| camModelName | String | 设备型号 | |
| storeId | String | 设备所在节点 ID | |
| storeName | String | 设备所在节点名称 | |
| hdVideo | int | 高标清视频状态, 0:关,1:开 | |
| volumeMute | int | 麦克风开关状态, 0:关,1:开 | |
| statusLight | int | 设备指示灯状态, 0:关,1:开 | |
| nightVision | int | 夜视开关状态, 0:关,1:开, 2:自动 | |
| deviceLongitude | String | 设备经度 | |
| deviceLatitude | String | 设备纬度 | |
| deviceAddress | String | 设备位置 | |
| hasPackage | Boolean | 是否有绑定套餐 | true:有;false:没有 |
| virtualDevice | int | 是否级联设备 | 0:否、1:是 |
| videoShareStatus | int | 视频共享状态 | 0:不共享、1:共享 (如果设备不是级联设备,则该值不返回) |
| accessTime | Long | 设备接入时间 | 10 位时间戳 |
| packageEffectiveInfo | List | ||
| nvrInfo | object | 本设备所属的 NVR 设备信息。非 NVR 下的通道设备,不会返回该参数 | |
| deviceType | String | 设备类型 | 设备类型:IPC、NVR |
| deviceProtocol | String | 设备协议 | 设备协议:千里眼协议、国标协议 |
| platformID | int | 底座 ID 信息 | 视联网设备,ID 值为 20 或 501;其余 ID 值,非视联网设备 |
packageEffectiveInfo 参数详情
| 名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| packageName | String | 套餐名 | |
| packageEffectiveTime | Long | 套餐生效时间 13 位时间戳 |
nvrInfo
| 名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| deviceId | String | NVR 设备通道编码 | |
| deviceName | String | NVR 通道名称 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data": [
{
"appId": "",
"deviceId": "gb_67793971881318000164",
"deviceName": "nvr通道名称2/",
"deviceSwitch": 1,
"deviceStatus": 2,
"createTime": 1721875608000,
"modifyTime": 1722302864000,
"camModelName": "GB",
"deviceLatitude": "",
"deviceLongitude": "",
"storeId": "1124195908992839680",
"storeName": "下下级1",
"virtualDevice": 0,
"deviceAddress": "",
"hasPackage": false,
"packageEffectiveInfo": [
],
"deviceType": "",
"deviceProtocol": "",
"nvrInfo": {
"deviceId": "67793971881188000147",
"deviceName": "nvr通道名称2/"
}
}
]
}