二、如何接收消息？

• 通过萤石云客户端/萤石云视频APP接收消息，这种方式用户不需要进行额外的操作，只要设备端触发了告警消息就可以通过萤石客户端收到

• 通过开放平台的告警消息消息接口（只能获取告警消息）获取，接口文档，注意：使用该接口时，需将参数status设置为2

• 通过消息推送获取消息。自定义一个回调地址，当设备上报消息后，开放平台会自动将消息推送到该回调地址，开通指南。目前可支持推送设备上下线消息、呼叫消息、托管设备变更消息、ISAPI 上行消息、告警消息等。

       注意事项：

1. 免费版套餐只推送10台设备消息，不会推送账号下所有设备的消息。
2. 消息推送用户可以自行在控制台开通，填入回调地址等关键信息即可
3. 用户必需提供https url作为回调地址
4. 当用户服务出现问题，超时2S以上没有及时处理消息，平台会判断这次推送失败，进入推送失败后续操作
5. 当用户webhook推送错误率在1分钟内失败率达到一半时，平台会对客户进行预降级操作，在预降级状态下长时间（一天）未恢复至正常状态则对客户推送进行降级处理，在降级时仅有十分之一的消息量会尝试推送至客户系统。

三、ISPAI消息相关信息汇总

一般海康设备有自己特有的功能，例如温度实时监控、GPS实时定位等，萤石开放平台只开放了设备的基础能力，这些特有的功能需要通过ISAPI协议与设备交互实现。目前平台无法直接使用，若想使用这部分能力，需先自行联系到海康设备销售，签署保密协议之后拿到ISAPI协议相关接口和报文后使用。

如何判断设备支持上报ISAPI消息到萤石云平台？

设备上传消息到公网需要走萤石云协议（接入DevSDK 1.5.13、1.5.53及之后版本）与设备确认以下信息：设备触发ezDevSDK_thirdparty_send_isapi_msg命令（需要接入DevSDK 1.5.13、1.5.53及之后版本）后才会上报消息。设备上报的消息中，文字消息是必选的，图片消息可以根据设备功能选择是否上报。如果设备端产生的消息中包含图片时，则需购买萤石开放平台的云录制服务才能获取到图片（注：ISAPI消息中的文字和图片是通过两种方式传到平台的，文字可以直接上传，图片则需要存在云端的存储空间内，需要使用时从云端获取图片相关信息，操作指南：https://open.ys7.com/bbs/article/80）。

设备上报到萤石云平台需简单三步：

• 打开设备本地消息开关

       打开本地消息开关需要在设备端的配置界面操作

• 打开平台布防开关

      打开平台的布防开关可以用接口操作布防，接口文档：https://open.ys7.com/help/56#device_switch-api1

• 开启ISAPI订阅

      开启设备的ISAPI订阅（EventScribe为YES 这一步需要用户自行联系设备端配合），用接口操作，接口文档 https://open.ys7.com/help/75，接口路径和报文内容需要找设备销售签署保密协议拿到

操作这三步之后，设备端产生ISAPI消息就会上报到平台了，后续就可以通过消息通道获取ISAPI消息。