API事件通知概述

星纵物联开放平台利用Webhook基于事件的通知,确保设备在向平台报告数据时,通知能够主动及时地传递给第三方应用程序。本文提供了星纵物联开放平台Webhook的详细说明,包括webhook的要求、工作流程以及支持的事件。

要求

  • 第三方应用程序支持Webhook功能。
  • 第三方应用程序必须拥有能够处理HTTPS请求的能力并安装有效的HTTPS证书。

Webhook 事件类型

星纵物联开放平台目前仅支持一种事件类型设备数据

当设备向星纵物联开放平台报告数据时,将触发HTTP回调,将报告的数据推送到你的回调URI,并携带一个JSON负载。该负载包含一个外部事件对象和一个包含相关事件详细信息的嵌套数据对象。

有关更多信息,请参考事件-设备数据

Webhook事件类型

以下图示展示了Webhook的工作流程:

从星纵物联开放平台接收Webhook事件通知,您需要从第三方应用程序获取一个Webhook URL,然后点击设置webhook事件通知

当设备向星纵物联开放平台报告数据时,系统将带有JSON负载的POST请求报告详细信息发送到Webhook URI。