4.3. 创建 REST API 连接器
Fuse Online 可以为支持 Hypertext 传输协议(HTTP)/1.0 或 HTTP/1.1 的 REST API 创建连接器。为此,Fuse Online 需要有效的 OpenAPI 3 (或 2)文档,用于描述您要连接到的 REST API。
您的 Fuse 在线环境提供 To Do 应用,它有一个 REST API 用于访问包含任务的数据库。您的环境还为这个 API 提供 OpenAPI 文档。
步骤
下载
todo app
的图标:- 在 Fuse Online 导航面板中,单击 Home。
- 将 URL 复制到文本编辑器中。
-
在 URL 的开头,插入
todo-
。 -
在 URL 的末尾,添加
/images/setuptools_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
注意如果 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。
-
在 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 有一个新条目。