接收设备消息
接收设备消息
适用场景与前提
开发者后端需要接收动检告警、设备上下线或标准能力事件。回调地址必须能从公网访问。已经创建应用并取得管理员 accessToken。见 创建应用。
海外没有消息通道拉取。不要实现 pullMessages 或消费组。
步骤
- 准备一个能从公网访问的 HTTPS 地址，收到 POST 后返回 HTTP 2xx 成功响应（建议 200）。状态码 200–399 视为成功；超时或非 2xx/3xx 计入失败。多次不返回有效响应后，平台会停止向该地址推送。
- 调用 setMessageCallback。
status为on时填写callbackUrl和callbackFlag。callbackFlag用逗号分隔，按需包含alarm、deviceStatus、numberstat、faceAnalysis、capabilityEvent。 - 解析报文。
alarm和deviceStatus使用did、cid和字符串msgType。capabilityEvent的msgType是 eventId，外壳包含deviceId和outputData。alarm与deviceStatus的类型见 事件消息类型（历史对照表见 legacy msgType），报文外壳见 事件消息格式定义（历史报文对照）。capabilityEvent见 事件总表 与 事件消息格式定义。 - 在后端处理完成后再转给自己的应用。用消息里的 id 去重。
字段以接口页为准。callbackFlag 与历史 msgType 见 事件消息类型定义；报文见 事件消息格式定义。接口说明见 推送配置。