5.3. 创建 API 供应商集成
要创建 API 供应商集成,请提供 OpenAPI 文档(.json
、.yaml
或 .yml
文件),用于定义集成可以执行的操作。Fuse Online 为每个操作创建一个执行流。编辑每个操作的流,以添加根据该操作的要求处理集成数据的连接和步骤。
先决条件
您可以为您希望集成的 REST API 操作提供或定义 OpenAPI 文档。
要试验,请下载
task-api.json
文件 的原始版本,它是 API 供应商快速入门的 OpenAPI 文档。当 Fuse Online 提示提供 OpenAPI 文档时,您可以上传此文件。或者,您可以指定原始task-api.json
文件的 URL,即 https://raw.githubusercontent.com/syndesisio/syndesis-quickstarts/1.13/api-provider/task-api.json。- 每个 OpenAPI 操作都有一个计划。
- 您为您要添加到操作流的每个应用程序或服务创建一个连接。
流程
- 在 Fuse Online 中,在左侧导航面板中,单击 Integrations。
- 点 Create Integration。
- 在 Choose a connection 页面上,单击 API Provider。
在 Start 与 API 调用页面集成 :
- 如果您有定义 REST API 操作的 OpenAPI 文档,请上传 OpenAPI 文档。
- 如果您需要定义 OpenAPI 文档,请选择 Create a new OpenAPI 3.x document 或 Create a new OpenAPI 2.x 文档。
点击 Next。
如果您上传了一个文档,请查看或编辑它:
- 点 Review/Edit 以打开 API Designer 编辑器。
根据需要查看和编辑。
另外,如果您的文档使用 OpenAPI 2 规格,如果您希望 API Designer 转换您的文档以符合 OpenAPI 3 规格,您可以点 Convert to OpenAPI 3。
- 在右上角,单击 Save 或 Cancel 以关闭编辑器。
- 点击 Next。
如果您要创建文档,则在 Fuse Online 的 API Designer 编辑器中打开:
- 定义 OpenAPI 文档,如使用 API Designer 设计和开发 API 定义 中所述。
- 在右上角,单击 Save,这将关闭编辑器。
- 点击 Next。
结果
Fuse Online 显示 OpenAPI 文档定义的操作列表。
后续步骤
对于每个操作,定义执行该操作的流。