摄像头信息查询（好望云平台）（API名称：getDeviceInfo）

功能介绍

用于与客户系统对接摄像头信息查询（好望云平台）。

接口名称	调用说明
获取Token	调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。
获取设备列表	调用该接口获取到isdp唯一设备ID。获取设备信息时，需要输入isdp唯一设备ID。
添加设备	调用该接口添加设备。
修改设备	调用该接口修改设备。
删除设备	调用该接口删除设备。
保存设备模板	调用该接口保存设备模板。

调用流程

图1 获取设备信息流程
点击放大

URL

请求方式	HTTPS地址	服务架构	消息体类型
POST	https://*isdp+域名*/openapi/v1/ivm/getDeviceInfo	OpenAPI	application/json

请求头

KEY	VALUE	是否必填	描述
Content-Type	application/json	是	无
Authorization	bearer ${access_token}	是	bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数	类型	是否必填	描述
isdpDeviceId	String	是	isdp唯一设备ID 获取isdp唯一设备ID API请参见：摄像头列表查询（好望云平台）（API名称：getDeviceList）

参数

类型

是否必填

描述

isdpDeviceId

String

是

isdp唯一设备ID

获取isdp唯一设备ID API请参见：摄像头列表查询（好望云平台）（API名称：getDeviceList）

响应参数

参数	类型	描述
isdpDeviceId	String	isdp唯一设备ID
deviceId	String	设备ID
channelId	String	通道ID
deviceName	String	设备名称
deviceState	String	设备状态
accessProtocol	String	接入协议
deviceType	String	设备类型
deviceSystemState	String	设备管理状态
description	String	描述
model	String	设备型号
manufacture	String	生产厂商
channelTotal	int	通道总数
streamTotal	int	每个通道码流数量
firmware	String	摄像头固件版本号
deviceAbility	String	能力集
mac	String	mac地址
createTime	String	创建时间
updateTime	String	更新时间
protocolVersion	String	协议版本
deviceIp	String	设备ip
devicePort	String	设备端口
projectName	String	项目名称
projectNumber	String	项目编码
deviceAddress	String	设备地址
fileId	String	图片编号
sysType	String	系统类型
fileSize	String	文件大小
fileName	String	文件名称
fileExt	String	文件扩展名
deviceAddressNumber	String	设备地址编号
deviceSubType	String	子设备类型
deviceAlarmStatus	String	设备告警状态
autoJoin	String	是否主动入会
battery	String	电量
ownnerId	String	设备责任人ID
longitude	String	经度
latitude	String	纬度
chatJid	String	IM群组ID
chatId	String	IM聊天ID
liveChannelId	String	频道播放ID
userName	String	设备使用人名称
ownnerName	String	设备责任人名称
webPlayUrl	String	web播放地址

请求示例

{
    "isdpDeviceId":"21024125389SL7002176-0"
}

响应示例

{
    "status": 1,
    "message": "SUCCESS",
    "error": null,
    "data":{
        "deviceId": "21024125389SL7002176",
        "isdpDeviceId": "21024125389SL7002176-0",
        "channelId": "0",
        "deviceName": "HoloSens SDC-0",
        "deviceState": "ONLINE",
        "accessProtocol": "HOLO",
        "deviceType": "WEBCAM",
        "deviceSystemState": null,
        "description": "",
        "model": "D3220-10-SIU",
        "manufacture": "huawei",
        "channelTotal": 0,
        "streamTotal": 0,
        "firmware": null,
        "deviceAbility": "intelligent,talk",
        "mac": null,
        "createTime": null,
        "updateTime": "2020-12-28 17:25:13",
        "protocolVersion": null,
        "deviceIp": null,
        "devicePort": null,
        "tenantId": 886,
        "projectNumber": "0001",
        "projectName": "XXXX项目",
        "deviceAddress": "XXXXXXXX基站",
        "fileId": "342955",
        "sysType": null,
        "fileSize": "106934",
        "fileName": "2020_12_28_17_29_04.jpg",
        "fileExt": "jpg",
        "deviceAddressNumber": "A0001",
        "webPlayUrl": "https://078dda04fc284058940039ebb5d0de25.APIgw.cn-north-4.xxxxxx.com/live/work003?app=vis&stream=XXXX",
        "verificationCode": "6h6yM3U1",
        "deviceManageState": "ACTIVATION",
        "deviceSubType": "IPC-CONCH",
        "creationDate": 1608968667000,
        "lastUpdateDate": 1609298831000,
        "lastUpdatedBy": null,
        "deviceAlarmStatus": "pulse",
        "autoJoin": null,
        "battery": null,
        "ownnerId": null,
        "longitude": null,
        "latitude": null,
        "chatJid": null,
        "chatId": null,
        "liveChannelId": null,
        "userName": null,
        "ownnerName": null
    },
    "timestamp": "2020-12-30T11:28:27.182+0800"
}