开发者平台

TP-LINK官网首页
开发者平台 / 视频管理系统(VMS)/API功能接口定义/ 设备管理

4.3.2 获取设备详情

接口说明:

名称 内容
URL https://xxx/tums/deviceManager/v1/getDeviceDetails
功能说明 设备列表中设备条目的扩展信息,用于详细信息的显示,仅包括持久化的信息
使用限制 用户对该设备有查看权限时可用

请求参数:

参数名称 参数描述
devId
String
设备信息表伪主键
限制:必选参数,数值型字符串

返回参数:

参数名称

参数描述

error_code

返回码,0 – 成功,其他- 失败,具体请参考返回码章节

result

deviceCatagory

String

设备分类

通用信息,不区分deviceCatagory的值

devId

String

设备信息表伪主键

deviceName

String

设备名称

deviceType

String

设备类型

deviceModel

String

设备型号

projectId

String

设备所属项目ID

regionId

String

设备所属区域ID

parentId

String

设备所属父设备的ID

firmVersion

String

固件版本

hardVersion

String

硬件版本

ethernet

String

MAC地址

ip

String

IP地址

deviceStatus

int

设备状态

0表示离线,1表示在线

仅当”deviceCatagory””nvr”时有效

ipcNum

int

通道数

ipcList

List< ipc >

已连IPC列表,具体参数有:

名称

内容

devId

String

IPC在设备信息表中的伪主键

deviceName

String

设备名称

 

仅当”deviceCatagory””videoPoint”时有效

protocol

String

设备连接协议

channel

int

通道编号,若为独立的IPC则为0

removed

int

该通道是否已被移除,0表示未被移除,1表示已被移除

username

String

设备用户名(加密后)

password

String

设备密码(加密后)

ipcCategory

String

IPC的具体型号

代码示例

        https: //xxx/tums/deviceManager/v1/getDeviceDetails
        request: {
            "devId": "14",
        }
        response: {
            "result": {
                "devId": "14",
                "deviceCatagory": "nvr",
                "deviceName": "第一台NVR",
                "deviceType": "TP-LINK网络硬盘录像机",
                "projectId": "1",
                "regionId": "10",
                "parentId": "0",
                "deviceModel": "TL-NVR1350",
                "firmVersion": "TL-NVR1350 V3.0",
                "hardVersion": "5.0.0",
                "ethernet": "10-20-30-40-50-60",
                "ip": "192.168.1.1",
                "deviceStatus": 1,
                "ipcNum": 8,
                "ipcList": [{
                    "devId": "18",
                    "deviceName": "24栋第五台IPC",
                }]
            },
            "error_code": 0
        }