获取设备详情
接口调用说明
请求地址 : /v1/api/device/get_device_details
请求方式 : POST
请求头
| 参数名 | 参数值 | 是否必须 |
|---|---|---|
| Content-Type | application/json | 是 |
| X-Token | 实际accessToken | 是 |
请求报文体
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | String | 是 | 设备序列号 |
//示例数据
{
"deviceSn" : "**********"//设备序列号
}
响应报文
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| msg | String | 是 | 状态码解释信息 |
| data | Object | 否 | 返回内容(详情见下表) |
data内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | String | 是 | 设备序列号 |
| deviceName | String | 是 | 设备名称 |
| deviceType | String | 设备类型(IPC/NVR/IPDOME/DVR) | |
| firmware | String | 固件版本 | |
| deviceState | int | 设备状态 (0离线 1在线 3未注册) | |
| mac | String | 设备mac地址 | |
| model | String | 设备型号 | |
| modType | String | 内部型号 | |
| ability | String[] | 设备能力集 | |
| channelCount | int | 通道个数 | |
| streamCount | int | 单通道码流个数,国标不支持码流切换 | |
| addTime | String | 设备添加时间,RFC3339格式 | |
| protocolVersion | String | 设备协议版本号 | |
| videoChannels | Object[] | ||
| protocolType | int | 是 | 协议类型:1-中维协议3.0(原公有云协议),2-国标,3-国标下级平台 |
| deviceIp | String | 是 | 设备ip |
| source | String | 是 | 设备来源 self:自有 hosting:托管 |
videoChannels内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| channelId | int | 是 | 视频通道号 |
| channelSn | String | 否 | 通道序列号 |
| channelGBId | String | 否 | 国标通道id |
| channelName | String | 是 | 视频通道名称 |
| channelState | number | 是 | 通道状态 (0离线 1在线 2 未配置) |
| channelType | String | 是 | 视频通道设备类型 |
| channelAbility | String[] | 是 | 视频通道能力集 |
| deviceId | String | 是 | 设备ID |
| firmware | String | 是 | 固件版本号 |
| model | String | 是 | 设备型号 |
| firstOnlineTime | String | 否 | 首次上线时间 |
| source | String | 是 | 通道来源 self:自有 hosting:托管 |
//示例数据
{
"code": 1000,
"msg": "OK",
"data": {
"deviceSn": "**********",
"deviceType": "IPC",
"deviceName": "CR1",
"firmware": "V2.2.5780",
"deviceState": 0,
"mac": "xx:62:90:33:xx:xx",
"model": "CR1",
"modType": "A26001",
"ability": ["ptz", "talk", "localstorage", "intelligent", "alarmsound", "pd", "ptzautotrace"],
"channelCount": 1,
"streamCount": 2,
"addTime": "2020-08-29T17:35:32.000+08:00",
"protocolVersion": "2.0.0",
"protocolType": 1,
"deviceIp": "192.168.89.250",
"source": "self",
"videoChannels": [{
"channelId": 0,
"channelSn": "xxxx",
"channelGBId":"34020000001310000001", //仅国标设备该字段有值
"channelName": "CR1",
"channelType": "IPC",
"channelState": 0,
"channelAbility": ["ptz", "talk", "intelligent", "alarmsound", "pd", "ptzautotrace"],
"deviceId":"**********",
"firmware":"V2.2.5779",
"model":"CR1",
"firstOnlineTime":"2020-12-12 11:11:10",
"source": "self"
}]
}
}
错误码
| 状态码 | 状态描述 |
|---|---|
| 1000 | 成功 |
| 1001 | 参数错误 |
| 1002 | 请求异常 |
| 1006 | AccessToken异常或过期 |
| 2008 | 设备不存在 |