Swagger
Swagger 连接器支持具有下列身份验证类型的 Swagger 文件：基本、OAuth 和应用程序密钥。此连接器支持
OpenAPI 2.0 和
OpenAPI 3.0 规范。
连接器发行版本
8.4.3 版本中提供了 Swagger 连接器。
支持的操作
所支持的触发器
无
所支持的授权
Swagger 连接器支持以下授权：
• “无”
• “基本”
• OAuth
• “应用密钥”
授权 Swagger
必须针对每个 Swagger 连接器操作完成 Swagger 授权。从身份验证模式列表中，选择其中一个授权方案：
• “无”- 提供 Swagger 文件 URL，如 https://petstore.swagger.io/v2/swagger.json
• “基本”- 要添加基本连接，请执行以下操作：
1. 从身份验证模式列表中，选择“基本”。
2. 在“Swagger 连接”字段中，单击“添加新的”。
3. 在“添加连接”窗口中，输入以下详细信息：
▪ “连接标签”- 已自动填充。您可以自行提供连接标签。
 |
标签区分大小写。请不要使用空格、某些特殊字符和前导数字。
|
▪ Swagger Url - Swagger.json 文件 Url。
▪ “用户名”- 目标应用程序的用户名。
▪ “密码”- 目标应用程序的密码。
4. 单击“添加”。新的授权随即添加至列表。
• OAuth - 要添加 OAuth 连接，请执行以下操作：
先决条件 - 添加新的 OAuth 连接前，请确保按照
配置连接器 OAuth 设置主题中 Swagger 部分所提供的步骤进行操作。
1. 从身份验证模式列表中，选择 OAuth。
2. 在 Swagger OAuth 字段中，单击“添加新 Swagger 登录”。
3. 在“参数”窗口中，输入 Swagger URL，然后单击“允许”。“添加授权”窗口随即打开。
4. 在“添加授权”窗口中，根据需要编辑“授权标签”，然后输入资源 URL。
5. 单击“添加”。
• “应用密钥”- 要添加新的应用密钥连接，请执行以下操作：
1. 从身份验证模式列表中，选择“应用密钥”。
2. 在 Swagger AppKey 字段中，单击“添加新的”。
3. 在“添加连接”窗口中，输入以下详细信息：
▪ “连接标签”- 已自动填充。您可以自行提供连接标签。
|
|
标签区分大小写。请不要使用空格、某些特殊字符和前导数字。
|
▪ Swagger Url - Swagger.json 文件 URL，例如 https://petstore.swagger.io/v2/swagger.json
▪ “应用密钥”- 输入 Swagger 应用密钥。
4. 单击“添加”。
|
|
单击“测试”验证授权。
|
Swagger 连接器限制
• 在 OpenAPI 3.0 规范中，server 字段具有定义多个基本 URL 的选项。当前实施不支持此选项，而是从 server 数组中获取第一个基本 URL。
• 允许在请求中使用以下媒体类型：application/json 和 application/x-www-urlencoded。不允许使用通配符。对于响应，允许 application/json。
• 不支持文件或图像上载和下载。
• 不支持多部分或表单数据。
• 参数序列化方法是所有参数的默认方法。
• type 字段中不支持使用“one of”, “anyOf”, “allOf”, “not”。
• 不允许多个身份验证。所有 API 应使用同一身份验证。