具有 Lambda 代理集成的 API Gateway 的 API 文档

如何解决具有 Lambda 代理集成的 API Gateway 的 API 文档

我定义了一个 SAM 应用程序，在 API 网关后面有几个 Lambda”

  MyApi:
    Type: AWS::Serverless::Api
    Properties:
      StageName: !Ref EnvType
      Auth:
        DefaultAuthorizer: LambdaTokenAuthorizer
        Authorizers:
          LambdaTokenAuthorizer:
            FunctionArn: !GetAtt AuthorizerLambda.Arn
  MyFunction:
    Type: 'AWS::Serverless::Function'
...
      Events:
        MyEvent:
          Type: Api
          Properties:
            RestApiId: !Ref MyApi
            Path: "/MyResource/{proxy+}"
            Method: post

显然，API Gateway 对代理资源知之甚少，例如：

代理路径
请求模型
响应模型

API Gateway 阶段生成的文档反映了这一点：

swagger: "2.0"
info:
  version: "1.0"
  title: "xxx-dev"
host: "xxx.execute-api.us-west-2.amazonaws.com"
basePath: "/dev"
schemes:
- "https"
paths:
  /MyResource/{proxy+}:
    post:
      responses: {}
      security:
      - LambdaTokenAuthorizer: []
securityDeFinitions:
  LambdaTokenAuthorizer:
    type: "apiKey"
    name: "Authorization"
    in: "header"
    x-amazon-apigateway-authtype: "custom"

有没有办法为 API Gateway 提供缺失位（代理路径、响应模型、请求模型）？最终，我需要一个足以生成客户端代码/允许进行一些集成测试的文档。类似的问题在这里 -> Aws lambda proxy Swagger template integration