Skip to content

获取设备详细信息

接口功能

根据 deviceId 获取该设备的详细信息。

请求地址

https://open.qly.cmviot.cn/v3/open/api/device/info

请求方式

POST,需要鉴权

请求参数

参数名称参数类型是否必需参数含义说明
deviceIdStringY设备 ID,查询多个 id 时以逗号拼接 

请求示例

{"deviceId":"xxxxS_d8gh390"}

响应参数

参数名称参数类型参数含义说明
resultCodeString响应码参考响应码定义
resultMsgString响应描述
dataList响应数据

data 数据模型

名称类型说明备注
appIdString开放应用 appiD 
deviceIdString设备 id 
deviceNameString设备名称 
deviceImeiString设备 imei 
deviceSwitchint设备开关状态0:关,1:开
deviceStatusint设备在离线状态0:离线,1:在线
createTimelong创建时间13 位毫秒时间戳
modifyTimelong修改时间13 位毫秒时间戳
camModelNameString设备型号
storeIdString设备所在节点 ID
storeNameString设备所在节点名称
hdVideoint高标清视频状态, 0:关,1:开
volumeMuteint麦克风开关状态, 0:关,1:开
statusLightint设备指示灯状态, 0:关,1:开
nightVisionint夜视开关状态, 0:关,1:开, 2:自动
deviceLongitudeString设备经度
deviceLatitudeString设备纬度
deviceAddressString设备位置
hasPackageBoolean是否有绑定套餐true:有;false:没有
virtualDeviceint是否级联设备0:否、1:是
videoShareStatusint视频共享状态0:不共享、1:共享 (如果设备不是级联设备,则该值不返回)
accessTimeLong设备接入时间10 位时间戳
packageEffectiveInfoList
nvrInfoobject本设备所属的 NVR 设备信息。非 NVR 下的通道设备,不会返回该参数
deviceTypeString设备类型设备类型:IPC、NVR
deviceProtocolString设备协议设备协议:千里眼协议、国标协议
platformIDint底座 ID 信息视联网设备,ID 值为 20 或 501;其余 ID 值,非视联网设备

packageEffectiveInfo 参数详情

名称类型说明备注
packageNameString套餐名
packageEffectiveTimeLong套餐生效时间 13 位时间戳

nvrInfo

名称类型说明备注
deviceIdStringNVR 设备通道编码
deviceNameStringNVR 通道名称

响应示例

{
    "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/"
            }
        }
    ]
}