5.3. 创建 API 供应商集成
要创建 API 供应商集成,提供一个 OpenAPI 文档(.json
、.yaml
或 .yml
文件),以定义集成可以执行的操作。Fuse Online 为每个操作创建一个执行流。编辑每个操作的网络流,以添加根据该操作要求处理集成数据的连接和步骤。
先决条件
您可以为您要集成的 REST API 操作提供或定义 OpenAPI 文档。
要试验,请下载
task-api.json
文件 的原始版本,它是 API 供应商快速入门的 OpenAPI 文档。当 Fuse Online 提示您输入 OpenAPI 文档时,您可以上传此文件。另外,您可以为 rawtask-api.json
文件指定 URL,即 https://raw.githubusercontent.com/syndesisio/syndesis-quickstarts/1.14/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 文档,或者创建一个新的 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 文档定义的操作列表。
后续步骤
对于每个操作,定义一个执行该操作的流。