用户回调接口 - 紫光云

文档中心 > 用户回调接口

用户回调接口

最近更新时间：2022-09-08

1、功能介绍

对指定空间，用户可以设置Callback地址，当空间内发送设备状态变更、流状态变更、告警等事件，会通知用户相关信息；
通过HTTP接口向用户发送POST请求，消息体使用JSON格式；
支持用户设置CallbackPrivateKey鉴权密钥，鉴权方式如下：
回调url：http://you.callback.com?AuthKey=timestamp-md5hash
timestamp：回调接口调用时间戳，为UTC时间。
md5hash：通过md5计算出的字符串，由0-9和小写字母a-z混合组成，固定长度32位。计算方法：
sstring = "timestamp-CallbackPrivateKey"
HashValue = md5sum(sstring)

2、请求参数

设备状态事件

参数	是否必选	参数类型	描述
Event	是	String	事件类型。取值：DeviceStatus
Time	是	Long	事件发生时间（unix时间戳）
GroupId	是	String	空间ID
DeviceId	是	String	设备ID
DeviceStatus	是	String	设备状态。取值：online（在线），offline（离线）

流状态事件

参数	是否必选	参数类型	描述
Event	是	String	事件类型。取值：StreamStatus
Time	是	Long	事件发生时间（unix时间戳）
GroupId	是	String	空间ID
DeviceId	是	String	设备ID
StreamStatus	是	String	流状态。取值：on（流启动），off（流停止）

录像状态事件

参数	是否必选	参数类型	描述
Event	是	String	事件类型。取值：RecordStatus
Time	是	Long	事件发生时间（unix时间戳）
GroupId	是	String	空间ID
DeviceId	是	String	设备ID
RecordType	是	String	录像类型。取值，manu（手动录像），time（定时录像）
RecordStatus	是	Long	录像状态。取值：1（录像中），2（录像正常结束），3（录像异常停止）