4.3. 创建 REST API 连接器
Fuse Online 可以为 REST API 创建连接器,以支持 Hypertext 传输协议(HTTP)/1.0 或 HTTP/1.1。要做到这一点,Fuse Online 需要有效的 OpenAPI 3(或 2)文档,用于描述您要连接的 REST API。
您的 Fuse 在线环境提供了 To Do 应用,具有用于访问包含任务的数据库的 REST API。您的环境还为这个 API 提供 OpenAPI 文档。
流程
下载
todo 应用的图标:- 在 Fuse Online 导航面板中点 Home。
- 将 URL 复制到文本编辑器中。
-
在 URL 的开头,插入
todo-。 -
在 URL 的末尾,添加
/images/todo_icon.png。 使用
http方案而不是https。其结果如下: http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com/images/todo_icon.png
-
将此 URL 粘贴到新的浏览器窗口中,并将
todo_icon.png文件下载到文件系统中的位置。您将在第 11 步中上传此图标。
识别 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
注意指定
http而不是https,如果 TLS 证书无效,则会避免运行时错误。在生产环境中,确保有效的证书就位,并且始终指定安全 URL(https)来获取 OpenAPI 文档。- 在 Fuse Online 导航面板中,点击 Customizations > API Client Connectors。
- 点 Create API Connector。
- 选择" 使用 URL "。
- 在输入框中,粘贴 OpenAPI 文档的 URL 并点 Next。
- 在 Review Actions 页面中,点 Next。如果您看到警告,您可以忽略它。
- 点击 Next。
-
在 Specify Security 页面中,接受 HTTP Basic Authentication 并指定用户名和密码,如
admin和admin。请注意,对于本示例应用程序,不会验证用户名和密码。 - 点击 Next。
在 Todo App API 概述页面中:
-
对于 Connector Icon,请单击 Choose File,然后导航到您在步骤 1 中下载的
todo_icon.png的位置。 - 如果要,可以在 Name 和 Description 字段中更改值。
-
在 Host 字段中,接受服务主机的名称,即
http://todo-app-proj217402.6a63.fuse-ignite.openshiftapps.com。 -
在 Base URL 字段中,接受与服务请求中的主机名后面的 URL 的一部分:
/api。
-
对于 Connector Icon,请单击 Choose File,然后导航到您在步骤 1 中下载的
点击 Save。
Fuse Online 显示 API 客户端连接器。刚刚创建的 Todo App API 有一个新条目。