检测您的 Swagger UI 版本
有时,您需要知道您正在使用的 Swagger UI 版本。
第一步是检测您当前使用的主版本,因为版本检测方法已发生变化。如果您的 Swagger UI 经过大量修改,您无法通过外观和感觉检测出您使用的主版本,那么您将不得不尝试两种方法来获取确切版本。
为了帮助您直观地检测您正在使用的版本,我们提供了支持图片。
Swagger UI 3.x
Swagger UI 3.x 的一些显著标识符
- API 版本以徽章形式显示在其标题旁边。
- 如果存在方案或授权,它们将显示在操作上方的条形区域中。
- “试用”功能默认未启用。
- 操作中的所有响应代码都显示在参数之后。
- 操作之后有一个模型部分。
如果您已确定这是您拥有的版本,要查找确切版本
- 打开您浏览器的 Web 控制台(不同浏览器之间有所不同)
- 在控制台中输入
JSON.stringify(versions)
并执行调用。 - 结果应类似于
swaggerUi : Object { version: "3.1.6", gitRevision: "g786cd47", gitDirty: true, … }
。 - 该示例中的版本将是
3.1.6
。
注意:此功能是在 3.0.8 版本中添加的。如果您无法执行此操作,则您可能正在使用较旧的版本,在这种情况下,第一步是升级。
Swagger UI 2.x 及更早版本
Swagger UI 2.x 的一些显著标识符
- API 版本显示在页面底部。
- 方案未渲染。
- 授权(如果已渲染)将显示在导航栏旁边。
- “试用”功能默认启用。
- 成功的响应代码将显示在参数上方,其余代码显示在参数下方。
- 操作之后没有模型部分。
如果您已确定这是您拥有的版本,要查找确切版本
- 导航到 UI 的源文件。可以在您的磁盘上,或通过浏览器中的“查看页面源”功能。
- 查找并打开
swagger-ui.js
- 在页面顶部,会有一个注释包含 Swagger UI 的确切版本。此示例显示版本
2.2.9
1/**2 * swagger-ui - Swagger UI is a dependency-free collection of HTML, JavaScript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API3 * @version v2.2.94 * @link https://swagger.org.cn5 * @license Apache-2.06 */