python - Swagger/OpenAPI 将文档放在哪里？

Question

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

标签： pythonswaggeropenapi

Answer 1

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

您可能使用openapi-generator或类似工具来生成您的 SDK - 需要从其他工具生成文档，例如ReDoc或SmartBear（Swagger 的原始作者）的工具。