【问题标题】:Where does Swagger/OpenAPI place documentation?Swagger/OpenAPI 将文档放在哪里?
【发布时间】:2021-01-29 22:35:15
【问题描述】:

我刚刚下载了一个 Swagger/OpenAPI 生成的 SDK。我知道 API 文档应该是由 Swagger 本身自动生成的......但是我正在查看文件目录并没有看到任何内容。我已经尝试在这个主题上搜索了几个小时,但没有任何帮助。任何帮助表示赞赏。

【问题讨论】:

    标签: python swagger openapi


    【解决方案1】:

    OpenAPI 是定义 API 的标准,它本身并不是生成 SDK 或文档的工具。

    您可能使用 openapi-generator 或类似工具来生成您的 SDK - 需要从其他工具生成文档,例如 ReDoc 或来自 SmartBear(Swagger 的原始作者)的东西。

    【讨论】: