5.3. 创建 REST API 连接器
Fuse Online 可以为支持 Hypertext 传输协议(HTTP)/1.0 或 HTTP/1.1 的 REST API 创建连接器。为此,Fuse Online 需要有效的 OpenAPI 2.0 文档,用于描述您要连接的 REST API。
您的 Fuse 在线环境提供 To Do 应用,它有一个 REST API 用于访问包含任务的数据库。您的环境还为这个 API 提供 OpenAPI (Swagger)文档。
流程
识别 Fuse Online 环境 OpenAPI 文档副本的 URL:
- 在 Fuse Online 导航面板中,单击 Home。
- 将 URL 复制到文本编辑器中。
-
在 URL 的开头,插入
todo-。 -
在 URL 的末尾,添加
swagger.json。 使用
http方案而不是https。结果如下:
http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com/swagger.json
注意如果 TLS 证书无效,则
http的规格而不是https避免了运行时错误。在生产环境中,确保存在有效的证书,并且始终指定安全 URL (https)来获取 OpenAPI 文档。- 在 Fuse Online 导航面板中,点 Customizations > API Client Connectors。
- 点 Create API Connector。
- 选择 Use a URL。
- 在输入框中,粘贴 OpenAPI 文档的 URL 并点 Next。
- 在 Review Actions 页面中,点 Next。如果您看到警告,您可以忽略它。
- 再次单击 Next,以接受 HTTP 基本身份验证。
在 Review/Edit Connector Details 页面中:
- 如果要,您可以更改 Name 和 Description 字段中的值。
-
在 Host 字段中,输入服务主机的名称,它类似如下:
https://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com。 -
在 Base URL 字段中,在服务请求中输入遵循主机名的 URL 部分:
/api。
点 Save。
Fuse Online 显示 API 客户端连接器。刚刚创建的 Todo App API 有一个新条目。