amazon-web-services - 如何在 AWS 中启用 swagger UI

Question

我使用 .Net 核心创建了无服务器应用程序并托管在 AWS 中。我可以通过在 API 网关下发布 API 文档来创建 swagger.json。

我正在寻找为这些 API 创建 swagger UI 的文档。
是否有可能在 AWS 本身中查看 swagger UI。

Answer 1

我不认为 AWS 在他们的一项服务中构建了一个 swagger UI。至少，我不知道。

但是，可以使用 S3 轻松创建 swagger 可视化。
Medium 上有一篇文章很好地解释了这一点。 [1]

基本上，您需要编写脚本的是:

使用静态网站托管创建 S3 存储桶

从 GitHub 下载静态 swagger UI 资源

将资源同步到 S3 存储桶

从 API 网关下载 swagger.json [2]

将 swagger.json 上传到 S3

修改 index.html 指向你的 swagger.json

这些步骤在 Medium 文章中有详细介绍。 [1]

引用

[1] https://medium.com/nirman-tech-blog/swagger-ui-for-aws-api-gateway-endpoints-a667f25f5a4b
[2] https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-export-api.html