6.2. 创建 HTTP 请求可以触发的集成
要触发与 HTTP GET
或 POST
请求集成的集成的执行,请添加 Webhook 连接,作为集成的启动连接。
流程
- 在左侧的 Fuse Online 面板中,单击 Integrations。
- 点 Create Integration。
- 在 Choose a connection 页面中,点 Webhook 连接。
在 Choose an action 页面上,选择 Incoming Webhook 操作。
在 Webhook Configuration 页面中,Fuse Online 显示 Fuse Online 为此集成生成的 Webhook 令牌。
构建 HTTP 请求时,此令牌是 URL 的最后一个部分。在发布此集成并运行后,Fuse Online 会显示 Fuse Online external URL,该 URL 在结束时使用这个令牌。
Webhook 配置页面 还包括" 默认响应 "和" 错误处理 "部分。Webhook 步骤将响应发送到调用它的 HTTP 客户端。响应包含一个返回代码,默认情况下,返回消息正文中的错误消息。
- 在 Default Response 下,在 return Code 字段中接受 Fuse Online 显示的默认响应,或使用下拉列表选择您想要的默认响应。在执行操作流时,流程不会返回任何配置的错误响应。通常,默认响应返回代码表示成功操作。
在 Error Handling 下,指明是否要在返回邮件正文中包含错误消息。
在开发过程中,您通常要返回错误消息。但是,在生产环境中,如果包含敏感或专有信息,您可能希望隐藏错误消息。错误消息是一个 JSON 格式的字符串,其中包含
响应代码
、类别
、消息
和错误元素,例如:{ responseCode: 404, category: "ENTITY_NOT_FOUND_ERROR", message: "SQL SELECT did not SELECT any records" error: SYNDESIS_CONNECTION_ERROR }
{ responseCode: 404, category: "ENTITY_NOT_FOUND_ERROR", message: "SQL SELECT did not SELECT any records" error: SYNDESIS_CONNECTION_ERROR }
Copy to Clipboard Copied! 请注意,在开发过程中,知道发生错误的最可靠方法是检查对调用者的响应中的
HTTP_RESPONSE STATUS
标头。您还可以检查集成 Pod 的日志INFO
消息。该集成的活动日志显示成功交换,且错误始终不会在 Activity 日志中显示。- 对于 webhook 步骤可能返回的每个错误,接受默认返回代码,或使用下拉列表选择另一个 HTTP 状态返回代码。
- 点击 Next。
在 Specify Output Data Type 页面中:
- 在 Select Type 字段中,选择 JSON schema。
- 在 Definition 字段中,粘贴在 HTTP 请求中定义参数的数据类型的 JSON 模式。有关 指定请求参数,请参阅关于 JSON 模式。
- 在 Data Type Name 字段中,指定此数据类型的名称。虽然这是可选的,如果您指定了名称,但它会出现在 data mapper Sources 列表中,这可让您更轻松地映射字段。
- (可选)在 Data Type Description 字段中提供一些可帮助您区分此数据类型的信息。
- 点击 Next。
- 添加完成与集成的连接。
- 添加任何其他所需连接。
- 添加任何其他所需步骤。
- 在启动连接后,添加数据映射步骤。
- 单击 Publish,为集成指定一个名称,以及描述、自定义环境变量和一个或多个标签。
- 单击 Save 并发布。