【问题标题】:Adding swagger to existing aws lambda (API Gateway)将 swagger 添加到现有的 aws lambda(API 网关)
【发布时间】:2018-07-24 20:21:35
【问题描述】:

是否有人知道有关如何将 swagger 文档添加到现有 aws lambda(API 网关)的有用文档的链接?某种菜鸟教程,因为我对招摇是完全陌生的。

我发现了一些链接,例如以下链接,它们对 lambda 不是很有用或不是特定的: https://blog.cloudboost.io/adding-swagger-to-existing-node-js-project-92a6624b855b https://github.com/swagger-api/swagger-node

【问题讨论】:

  • 我不认为您将 Swagger 与 Lambda 一起使用,而是与 API Gateway 一起使用。您是否使用 API Gateway 为您的 Lambda 提供 http 请求?如果是这样,不妨看看这里:docs.aws.amazon.com/apigateway/latest/developerguide/…
  • 是的,我是。但是这个链接对我来说是安静的高水平。关于我如何实现这一点,是否有任何详细的文档?
  • 你使用serverless框架吗?
  • 是的,我正在使用无服务器

标签: aws-lambda swagger aws-api-gateway


【解决方案1】:

我只将 Swagger 与 API Gateway 与旧 v0.5 版本的 serverless 框架一起使用,因为有一个插件可以轻松支持这一点。 但是,当serverless 成熟到 v1.0 及更高版本时,当时还没有很好的 Swagger 集成插件。

您可以查看以下链接:

Serverless Github Issue: Swagger Integration

Reckon-Limited/serverless_swagger

doapp-ryanp/serverless-plugin-swag

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

【讨论】:

    【解决方案2】:

    在我的后端团队中,我们使用智能熊提供的工具swagger inspector 来编写文档,并通过它使用swagger hub 完成对文档的调整。

    Swagger 检查器在您的端点上提出请求并基本上提取必要的文档,但是您需要调整一些东西,这不是最好的解决方案,但它会有所帮助...

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2021-07-06
      • 1970-01-01
      • 1970-01-01
      • 2019-05-02
      • 1970-01-01
      • 2020-06-21
      • 2018-11-10
      • 1970-01-01
      相关资源
      最近更新 更多