如何存储和组织 swagger 文件?

How to store and organize swagger files?

假设我需要为 ~1000 个 REST API 存储和组织 API 文档。每个 API 都提供 swagger 格式的 JSON 文件和带有图像的文本文件,用于指南、教程和代码示例。用户可以更新文档,通过 API 名称、URL、请求字段等浏览和查询,还可以搜索文本文件。

我可能可以将文本文件和图像存储在某些云存储(例如 S3)中并创建全文搜索索引。我想知道如何存储 swagger 文件。我应该将它们像文本文件一样存储在云存储中还是将它们存储在文档数据库中(例如 Mongo)?

你怎么看?

“swagger 文件”到底是什么意思?从 openAPI schema files?

生成的输出

我想知道为什么要将其托管在数据库中?每个“REST API”有一个 S3 存储桶并使该存储桶成为 static web server 不是那么容易吗?让它自动访问并且从不依赖于与辅助服务的连接?

您可能仍想使用数据库来组织 user/editors/admins,但最终我会简单地将所有内容托管在 CDN 中,并确保在生成新更新时覆盖并清除缓存 (CloudFront),您甚至可以使用“文件夹”在该存储桶中托管一个版本,这样如果出现任何错误,用户可以轻松恢复到以前的版本...

你不同意吗?