将Swagger添加到现有的AWS Lambda（API Gateway）

Question

有没有人知道如何将Swagger文档添加到现有的AWS Lambda（API网关）中的有用文档链接？最好是一些新手教程，因为我完全不懂Swagger。

我发现了一些链接，例如以下链接，但它们并不那么有用，也不是针对Lambda的： https://blog.cloudboost.io/adding-swagger-to-existing-node-js-project-92a6624b855b https://github.com/swagger-api/swagger-node

- aiiwa

---

我认为你不应该使用Swagger来处理Lambda，而是应该使用API Gateway。你是否正在使用API Gateway来为Lambda提供HTTP请求服务？如果是的话，可以参考这里：https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-export-api.html#api-gateway-export-api-download-swagger-yaml-with-apig - Jonatan

是的，我是。但是这个链接对我来说有点高级了。是否有更详细的文档可以告诉我如何实现这个？ - aiiwa

你使用 serverless 框架吗？ - Noel Llevares

是的，我正在使用无服务器。 - aiiwa

Answer 1

我只在旧版本的serverless框架中使用过Swagger和API Gateway，因为有一个支持这个的插件。然而，当serverless升级到v1.0及以上时，就没有很好的Swagger集成插件了。

以下是您可以查看的链接:

Serverless Github问题: Swagger集成

Reckon-Limited/serverless_swagger

doapp-ryanp/serverless-plugin-swag

然而，我个人不再使用上述内容，因为我的大型无服务器项目现在使用GraphQL(其中API文档是标准工具的一部分 :-) )而不是REST。

- Noel Llevares

Answer 2

在我的后端团队中，我们使用一个由Smart Bear提供的工具Swagger Inspector来进行文档编写，并通过它来完成Swagger Hub的文档调整。

Swagger Inspector会对您的端点发出请求并基本上提取必要的文档信息，但有些东西需要您进行调整，这不是最好的解决方案，但它确实有所帮助...

- bigLucas