Rails：记录使用swagger-blocks消耗json params的post endpoint？

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”。您可以查看此specification是否有违规行为。