开发者平台

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

4.3.3 获取设备列表详情

接口说明:

名称 内容
URL

https://xxx/tums/deviceManager/v1/getDeviceListDetails

功能说明 设备列表中设备条目的扩展信息,用于详细信息的显示,仅包括持久化的信息
使用限制 用户对该设备有查看权限时可用

请求参数:

参数名称 参数描述

devIdList

List<Object>

设备信息表伪主键的数组

限制:必选参数,数值型字符串数组

返回参数:

参数名称 参数描述

error_code

int

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

result

deviceDetailsList

List<Object>

设备信息列表,具体字段有:

名称

内容

通用信息,不区分”deivceCatagory”的值

devId

String

设备信息表的伪主键

deviceCatagory

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表示在线

capability

long

设备能力集

仅当”deviceCatagory””nvr”时有效

ipcNum

int

通道数

protocol

String

设备接入协议

ipcList

List<ipc>

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

名称

内容

devId

String

设备信息表伪主键

deviceName

String

设备名称

仅当”deviceCatagory””videoPoint”时有效

channel

int

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

protocol

String

设备接入协议

removed

int

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

password

String

设备密码(加密后)

username

String

设备用户名(加密后)

仅当”deviceCatagory””decoder”时有效

channel

int

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

protocol

String

设备接入协议

removed

int

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

代码示例

          https://xxx/tums/deviceManager/v1/getDeviceListDetails
          request:
          {
               "devIdList": ["14"]
          }
          response:
          {
              "result":
              {
                  "deviceDetailsList": [
                      {
                        "deviceCatagory": "nvr",
                        "deviceName": "第一台NVR",
                        "deviceType": "TP-LINK网络硬盘录像机",
                        "projectId": "1",
                        "protocol": "TP-LINK",
                        "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
          }