连接Webhook

Webhook 是一种被动式的数据通信机制，用于实时推送数据。它允许一个系统在某个事件发生时，自动把数据发送到另一个系统提供的 URL 地址，从而实现系统间的自动联动。

1. 选择数据类型

在数据源编辑窗口中，在左侧选择“添加数据”选项卡，然后在右侧点击接口分类中的“Webhook”按钮：

点击“Webhook”按钮后会弹出输入“连接 Webhook”的设置框，如下图所示：

在此处可以修改Webhook 的连接名称，如下图所示：

数据响应分为实时更新和累积更新两种方式，它们都用于实现 Webhook 功能，但它们的工作原理和提供的功能有所不同，下面简单为大家介绍一下它们的特点。

实时更新是指每次外部系统通过 Webhook 向山海鲸发送数据时，会覆盖原有数据，展示的是最新的一条或一组数据。通常适用于那些需要实时展示当前状态或最新数据的场景，例如设备运行状态、实时监控等传感器数据、安全风险告警事件等。

累积更新是指每次数据推送会被追加记录下来，形成数据积累。通常适用于需要保留历史记录、用于趋势分析或报表的场景，例如物流轨迹记录、用户行为日志、销售数据每日新增等。

该 url 为山海鲸自动生成的接收端地址，用于接收外部系统发送的数据，无法修改。外部系统可以通过 HTTP 请求向这个 URL 推送 JSON 或表单数据。

点击右侧“复制”按钮可以快速复制该 url，如下图所示：

在下方需要定义表格字段，可以修改“表名”，如下图所示：

例如以下示例代码，我们可以根据数据字段类型来进行表的设置。

{
  "order_id": "ORD1001",
  "amount": 299.9,
  "created_at": "2025-07-17T09:30:00Z"
}

根据以上代码，在表格中的设置，如下图所示：

数据响应类型选择“累积响应”时，可在下方设置“最大数据量”，用于限制“累积响应”模式下 Webhook 推送数据的最大保留数量，确保既能连续展示历史，又不会内存溢出或性能下降。

点击“+添加数据表”，可以新建一个空白数据表，如下图所示：

点击右侧按钮可以删除当前选中的数据表或字段，如下图所示：

设置完成后，点击“确定”按钮即可完成 Webhook 数据的连接。

为数据表格组件绑定 Webhook 数据，效果如下图所示：