Ruby on rails Rails：使用swagger块记录使用json参数的post端点？

在rails中使用swagger块，我会记录一个使用单个json体的post端点，例如：

{ id:1， 姓名:比尔,， 年龄: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

---

JSON在语法上似乎是正确的，只是如果您试图创建，默认情况下应该自动生成id。您可以检查是否有违规行为。

我应该在前面更具体一些，但是我用来生成我的招摇过市文档的代码似乎在输入参数之外生成了错误。我刚刚在原来的帖子中也添加了这个。