跳到主要内容

Webhook触发

Webhook 触发节点用于接收外部应用或服务发送的 HTTPS 请求，并自动触发服务，实现与其他系统的数据对接。

使用场景​

  • 第三方系统回调：当第三方系统需要将处理结果回传至易星云时，可通过调用易星云提供的 Webhook URL，实现数据的实时传输和处理。
  • 事件驱动处理：外部系统在特定事件发生时，向易星云的 Webhook URL 发送请求，触发相应的流程处理。

详细配置​

以下是配置 Webhook 触发节点的步骤：

  1. 创建 Webhook 触发服务

    • 在易星云平台中，进入服务流程设计界面，选择创建新的服务流程。
    • 在触发方式中，选择 Webhook 触发。

  2. 获取 Webhook URL

    • 服务流程创建后，系统会为您生成一个唯一的 Webhook URL。外部应用只需将此地址添加到回调地址中，即可将数据自动推送过来。

      image-20250310011318305

  3. 解析生成样本数据

    在第一次配置时，需要先建立数据样本，后续推送进来的数据就可以根据数据样本在服务流程中使用。

    • 从请求范例生成：选择此方式后，需要在3分钟内向 Webhook URL 发送一条 GET 或 POST 请求，系统接收到数据后，会自动解析。

      image-20250310011144858

    • 从 JSON 数据范例生成：根据准备好的 JSON 格式的数据解析生成样本数据。

      image-20250310011215552

    • 从键值对生成：手动输入参数名称和值，系统将根据输入生成参数列表。

      image-20250310011255280

  4. 使用数据

    确定好样本数据后，后续节点即可使用传递进来的数据。

    image-20250310010939418

  5. 设置响应方式

    外部应用在向 Webhook 发起请求后，可以在服务流程配置中自定义响应方式及返回内容。

    • **直接返回固定文本給请求地址：**对方请求时，立即以返回一段固定文本給请求方

    image-20250310010043707

    • **直接返回服务节点数据对象給请求地址：**选择一个代码块、发送API请求、JSON解析或调用已集成API节点，把它返回的数据对象立即返回給请求方，服务执行时间30s以内

    image-20250310010325914

    • **直接返回服务节点的字段值給请求地址：**将所选节点的字段值结果立即返回給请求方，支持选择返回格式，服务执行时间30s以内

    image-20250310010831144

  6. 安全设置

    默认情况下，只要获取到 Webhook URL 即可发送请求。为了提高安全性，可以通过以下方式进行设置：

    • Basic Authentication鉴权：开启应用授权后，请求参数需包含Authorization: Basic 。

      image-20250310005926498

      秘钥鉴权：仅允许在白名单中的 IP 地址发送请求。

      image-20250310010010795

完成以上配置后，您的 Webhook 触发服务即可正常接收外部请求，并根据配置执行相应的服务流程。