云服务器内容精选

  • 基本消息结构体 推送消息给企业ISV平台时,各参数定义如下: 请求头header,当用户设置auth_key的值,会携带这两个请求头 字段名 类型 是否可为空 说明 X-Ivm-Timestamp Int64/long整型 不为空 UNIX时间戳,整形正数,固定长度10,1970年1月1日以来的秒数,表示回调请求发起时间。 X-Ivm-Signature String 不为空 接口请求token,token生成方式,为将callback_url,X-Ivm-Timestamp,auth_key三个字段进行拼接,字段中间以竖线(|)分割,后计算sha256值。即 X-Ivm-Signature = sha256(callback_url|X-Ivm-Timestamp|auth_key),回调消息接收端接收请求后可自行计算该值并做比较,若不相等,则请求非法 结构体req 字段名 类型 是否可为空 说明 message_id Int64/long整型 不为空 消息ID:该消息的唯一标识,根据时间戳生成(18到32位的数字),无重复 message_type String 可能为空 消息类型:分为设备智能告警消息、设备异常告警消息、设备解绑消息和设备智能数据消息四大类 枚举值: 设备智能告警消息: device_alarm 智能告警消息,包含目标智能告警,口罩告警,周界告警,人群态势告警及第三方智能告警消息等 设备异常告警消息: device_status 设备异常消息,包含设备/通道上下线告警,通道名称修改,以及设备升级失败 设备解绑消息: device_unbind 设备解绑和套餐解绑的消息 设备智能数据消息: target_data 智能业务中的目标及目标整体业务 third_data 第三方智能业务,目前是提供整个数据包,使用方需自行解析。订阅时要和第三方智能告警数据区分开 vehicle_data 智能业务中的机非人业务 head_shoulder_data 智能业务中的头肩业务 behavior_analysis_data 智能业务中的行为分析与人车物分离 micro_checkpoint_data 智能业务中的微卡口业务 data Object 可能为空 智能告警信息: 当 message_type 不同时,data 格式不同,可参考message_type里各种类型的介绍; 当智能类型算法升级时,可能会在推送的结构体里添加新字段; test Boolean 不为空 当test字段为true时,表示这是配置回调URL时测试是否可访问的消息,被调用方需要返回响应码为200。注意,此时message_type和data字段不传。 当test字段为false时,表示这是一条推送消息,message_type和data字段正常传入。 父主题: 告警推送消息体结构
  • 消息结构体介绍 表1 message_type为device_unbind时,data结构体如下: 字段名 类型 说明 message_type(Json内层) String 消息类型 枚举值: DELETE_DEVICE 设备删除 UNBIND_DEVICE 设备解绑 UNBIND_MANAGE 接入调阅解绑 UNBIND_MOTION 动检云存储解绑 UNBIND_NORMAL 连续云存储解绑 UNBIND_DATAFLOW 行业数据流解绑 devices Array of Device Objects 设备对象,包含一或多个设备的对象 表2 Device 字段名 类型 说明 device_id String 设备ID channel_id String 通道ID message Message Object 套餐解绑时的详细信息 表3 Message 字段名 类型 说明 resource_id String 套餐ID 示例一、删除设备 { "message_id": 1676624636867660931, "message_type": "device_unbind", "data": { "message_type": "DELETE_DEVICE", "devices": [ { "device_id": "11111111111111111111", "channel_id": "", "message": null } ] }, "test": false } 示例二、解绑套餐 { "message_id": 1676624334098133709, "message_type": "device_unbind", "data": { "message_type": "UNBIND_MANAGE", "devices": [ { "device_id": "210123456SMY***", "channel_id": "0", "message": { "resource_id": "791afbac769f4edea98fea92bc5fcc7d" } } ] }, "test": false }