7.2. 创建 HTTP 请求可以触发的集成

流程

1. 在左侧的 Fuse Online 面板中，单击 Integrations。
2. 点 Create Integration。
3. 在 Choose a connection 页面上，单击 Webhook 连接。

4. 在 Choose an action 页面中，选择 Incoming Webhook 操作。

   在 Webhook Configuration 页面中，Fuse Online 显示 Fuse Online 为此集成的 webhook 令牌。

   当您构建 HTTP 请求时，此令牌是 URL 的最后一部分。发布此集成并正在运行后，Fuse Online 会显示 Fuse Online 外部 URL，该 URL 的末尾有此令牌。

   Webhook 配置页面 还包括 Default Response 和 Error Handling 部分。Webhook 步骤向调用它的 HTTP 客户端发送响应。响应包含一个返回代码，默认情况下，返回消息正文中的错误消息。

5. 在 Default Response 下，在 return Code 字段中接受 Fuse Online 显示的默认响应，或使用下拉列表选择您想要的默认响应。当执行操作流时，流不会返回任何配置的错误响应，流会发送此响应。通常，默认响应返回代码表示操作成功。

6. 在 Error Handling 下，指示您是否要在返回消息的正文中包含错误消息。

   在开发过程中，您通常想返回错误消息。但是，在生产环境中，如果包含敏感或专有信息，您可能希望隐藏错误消息。错误消息是一个 JSON 格式的字符串，其中包含 responseCode、类别、消息 和错误元素，例如：

      {
         responseCode: 404,
         category:  "ENTITY_NOT_FOUND_ERROR",
         message: "SQL SELECT did not SELECT any records"
         error: SYNDESIS_CONNECTION_ERROR
       }

   请注意，在开发过程中，了解出错的最可靠方法是检查对调用者的响应中的 HTTP_RESPONSE STATUS 标头。您还可以检查集成 pod 的日志中的 INFO 信息。集成的 Activity 日志显示成功的交换，错误并不总是在 Activity 日志中可见。

7. 对于 Webhook 步骤可能会返回的每个错误，接受默认的返回代码，或使用下拉列表选择另一个 HTTP 状态返回代码。
8. 点击 Next。

9. 在 Specify Output Data Type 页面中：

   1. 单击 Select Type 字段，然后选择 JSON 模式。
   2. 在 Definition 字段中，粘贴用于定义 HTTP 请求中参数的数据类型的 JSON 模式。请参阅关于 JSON 模式以指定请求参数。
   3. 在 Data Type Name 字段中，指定此数据类型的名称。虽然这是可选的，但如果您指定了名称，它会出现在 data mapper Sources 列表中，这样可方便正确映射字段。
   4. 另外，在 Data Type Description 字段中，提供一些可帮助您区分此数据类型的信息。
   5. 点击 Next。
10. 将完成连接添加到集成。
11. 添加任何其他所需连接。
12. 添加任何其他必要的步骤。
13. 在启动连接后立即添加数据映射程序步骤。
14. 单击 Publish，为集成提供名称和可选的描述，然后单击保存并发布。