修改设备（API名称：updateDevice）

功能介绍

该接口用于与客户系统对接修改设备。

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

调用流程

图1 修改设备流程

URL

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

请求头

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

请求参数

参数	类型	是否必填	描述
deviceId	String	是	设备编号，请输入数字、英文、_、#等字符获取设备编号API请参见：摄像头列表查询（好望云平台）（API名称：getDeviceList）
isdpDeviceId	String	是	isdp唯一设备ID 获取isdp唯一设备ID API请参见：摄像头列表查询（好望云平台）（API名称：getDeviceList）
deviceName	String	是	设备名称，请输入数字、中文、英文、_、-等字符
deviceAddress	String	否	设备位置信息
projectName	String	否	项目名称
projectNumber	String	否	项目编码
model	String	否	model
deviceType	Long	是	设备类型可选值WEBCAM/MONITOR_BALL/BODY_WORN_CAMERA/INTELLIGENT_SAFETY_HELMET/INTELLIGENT_MINER_L IGHT/MOBILE/IVS1800/IVS3800 多个以英文逗号分隔，不传默认查询所有
deviceManageState	String	否	设备管理状态可选值NoActivation/ ACTIVATION，不传默认空
deviceSubType	String	否	设备子类型
manufacture	String	否	制造商
description	String	否	描述
deviceAddressNumber	String	否	设备位置编码
autoJoin	String	是	是否主动接入视频可选值Y或者N，Y标识开启，N标识不开启
enableEndSide	String	是	是否开启边缘AI 可选值Y或者N，Y标识开启，N标识不开启
enableVideoRecording	String	是	是否开启视频录制可选值Y或者N，Y标识开启，N标识不开启
ownnerId	Long	否	设备责任人Id
deviceUserId	Long	否	设备使用人Id
customerOrgName	String	否	使用区域名称
customerOrgCode	String	否	使用区域编码
buOrgId	Long	是	组织Id
buOrgName	String	是	组织名称

响应参数

参数	类型	描述
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播放地址
bindStatus	Integer	设备绑定状态
bindUserId	Long	设备绑定的用户Id
buOrgId	Long	设备所在组织Id
buOrgName	String	设备所在组织名称
coordType	String	坐标类型
creationDate	Date	创建时间
deviceManageState	String	设备管理状态
deviceStateBefore	String	设备上报之前的状态
deviceTypeName	String	设备类型名称
deviceUserId	Long	设备使用人Id
deviceUserName	String	设备使用人名称
deviceUserNameOnly	String	设备使用人名称
enableEndSide	String	是否开启边缘AI
enableVideoRecording	String	是否开启录像
groupId	Long	群组Id
groupName	String	群组名称
integrationPlatform	String	集成平台
lastReportTime	Date	最后一次上报时间（时间戳）
lastUpdateDate	Date	最后更新时间（时间戳）
lastUpdatedBy	Long	最后更新人
onlineDuration	Long	设备在线时长
stateChangeReason	String	设备状态改变原因
stateChangeReasonCode	String	设备状态改变原因码
storageRemain	Long	存储保留
storageTotal	Long	存储总计
deviceTypeName	String	设备类型名称
tenantId	Long	租户Id

请求示例

{
        "deviceId" : "rerererr",
        "deviceName" : "rerererr",
        "deviceAddress" : "",
        "projectName" : null,
        "model" : "",
        "deviceType" : "INTELLIGENT_SAFETY_HELMET",
        "deviceManageState" : "ACTIVATION",
        "deviceSubType" : "其他",
        "manufacture" : "",
        "description" : "",
        "deviceAddressNumber" : "",
        "projectNumber" : null,
        "isdpDeviceId" : "rerererr--1",
        "ownnerId" : null,
        "deviceUserId" : null,
        "buOrgName" : "杨凌作业系统测试",
        "buOrgId" : 830,
        "customerOrgName" : "",
        "customerOrgCode" : "",
        "autoJoin" : "Y",
        "enableEndSide" : "Y",
        "enableVideoRecording" : "Y"
}

响应示例

{
         "status" : 1,
         "message" : "SUCCESS",
         "error" : null,
         "data" : {
                   "deviceId" : "rerererr",
                   "deviceName" : "rerererr",
                   "publicKey" : null,
                   "deviceState" : null,
                   "deviceType" : null,
                   "description" : "",
                   "createTime" : null,
                   "updateTime" : null,
                   "accessProtocol" : null,
                   "manufacture" : "",
                   "channelTotal" : 0,
                   "streamTotal" : 0,
                   "deviceSystemState" : null,
                   "model" : "",
                   "firmware" : null,
                   "deviceAbility" : null,
                   "mac" : null,
                   "protocolVersion" : null,
                   "deviceIp" : null,
                   "devicePort" : null,
                   "tenantId" : 0,
                   "lastUpdatedBy" : 0,
                   "createdBy" : 0,
                   "projectNumber" : "",
                   "projectName" : "",
                   "deviceAddress" : "",
                   "deviceAddressNumber" : "",
                   "fileId" : null,
                   "sysType" : null,
                   "fileSize" : null,
                   "fileName" : null,
                   "fileExt" : null,
                   "webPlayUrl" : null,
                   "verificationCode" : null,
                   "password" : null,
                   "isdpDeviceId" : "rerererr--1",
                   "channelId" : null,
                   "deviceAlarmStatus" : null,
                   "deviceManageState" : "",
                   "deviceSubType" : null,
                   "sort" : null,
                   "sortBy" : null,
                   "autoJoin" : "Y",
                   "battery" : null,
                   "ownnerName" : null,
                   "ownnerId" : null,
                   "deviceGbUsername" : null,
                   "deviceGbPassword" : null,
                   "buOrgId" : 830,
                   "deviceUserId" : null,
                   "deviceUserName" : null,
                   "longitude" : null,
                   "latitude" : null,
                   "coordType" : null,
                   "buOrgName" : "杨凌作业系统测试",
                   "storageTotal" : null,
                   "storageRemain" : null,
                   "onlineDuration" : null,
                   "groupName" : null,
                   "enableEndSide" : "Y",
                   "updateDeviceType" : true,
                   "networkType" : null,
                   "systemVersion" : null,
                   "applicationVersionName" : null,
                   "applicationVersionCode" : null,
                   "enableVideoRecording" : "Y",
                   "deleteFlag" : 0,
                   "functionCode" : null,
                   "functionAutho" : null,
                   "ivsLoginAccount" : null,
                   "ivsLoginPsw" : null,
                   "isPlayNode" : 0,
                   "ivsLoginUrl" : null,
                   "parentDeviceId" : null,
                   "integrationPlatform" : null,
                   "subDeviceTotal" : 0,
                   "activeType" : false,
                   "orgId" : null,
                   "orgPath" : "-1.830",
                   "userId" : null,
                   "searchType" : 0,
                   "domainCode" : null,
                   "stateChangeReason" : null,
                   "stateChangeReasonCode" : null,
                   "deviceStateBefore" : null,
                   "cloudRecords" : null,
                   "chatJid" : null,
                   "chatId" : null,
                   "liveChannelId" : null,
                   "startTime" : null,
                   "endTime" : null,
                   "status" : 0,
                   "exportExcel" : null,
                   "customerOrgName" : "",
                   "customerOrgCode" : "",
                   "orgIdList" : null,
                   "groupId" : null,
                   "lastReportTime" : null,
                   "reportTime" : null,
                   "reportType" : false,
                   "createState" : null,
                   "filter" : null,
                   "helmetFilter" : null,
                   "platFilter" : null,
                   "webcam" : false
         },
         "timestamp" : "2022-09-06T18:10:18.883+0800"
}