Swagger 文件是否有替代 UI

Question

我们目前正在Postman用于构建和测试我们的 REST 端点。在分享收藏时，他们的产品存在一些严重的缺陷。基本上你不能对文档使用源代码控制，因为它会在你导入时更改 json 文件中的所有 guid。

所以我们正在考虑可能切换到Swagger，Swagger 的问题是这SwaggerUI对用户不是很友好。我们喜欢 Postman 使您能够将您的收藏分解为文件夹，并为您提供一个分屏，您可以在其中运行请求并查看输出。

是否有任何第三方工具可以Postman为Swagger文件提供样式界面？即很容易找到一组资源的方法，并调用它。

Answer 1

Swagger UI为您的 API提供实时文档，您始终可以对其进行自定义以满足您的需求。这并不难。从文档：

定制

您可以选择为您的组织自定义 Swagger UI。以下是其各种目录中内容的概述：

• dist：包含一个可以部署在服务器上或从本地机器加载的发行版。
• dist/lang: Swagger 本地化。
• lib：包含 Swagger UI 所依赖的 JavaScript 依赖项。
• node_modules：Swagger UI 用于其开发的节点模块。
• src/main/templates：用于呈现 Swagger UI 的把手模板。
• src/main/html：HTML 文件、一些图像和 CSS。
• src/main/javascript: 主要代码。

有关其他详细信息，请查看Swagger UI 文档。

主题

• 作为默认 Swagger UI 主题的替代方案，请查看此Swagger UI 响应式主题，其灵感来自 Auth0 API 资源管理器。

• 您可能还喜欢这些主题，它们只是对默认 Swagger UI 主题的修改。

警告

请注意扬鞭是不是一个API测试工具。它是一个API 文档工具。