Rails:记录使用招摇块消耗json参数的后端点

Question

在rails中使用swagger-block，我是否会记录一个消耗单个json正文的post端点，例如：

{ "id":"1", "name": "bill", "age":"22" }

无论我做什么，我的测试总是说我的设置不是有效的 Swagger 2.0 JSON 架构。

以下是我用来生成文档的代码：

swagger_path '/list/add' do
        operation :post do
          key :summary, 'Add person to list'
          parameter name: :id, in: :body, required: true, type: :string
          parameter name: :name, in: :body, required: true, type: :string
          parameter name: :age, in: :body, required: true, type: :string
          response 200 do
            key :description, 'Successfully added to list'
          end
        end
      end

Answer 1

JSON 在语法上似乎是正确的，但如果您尝试创建，默认情况下应自动生成"id"。您可以检查此规范是否存在违规行为。