如何用大摇大摆的描述建立模型？

Question

我想用 image [json] 那样的招摇来构建模型，我有类似 this 的东西。我想在块内有描述标题和数据。下面是代码：

require 'swagger_helper'
describe 'Users API' do
  path '/register/first_step' do
    post 'First step of Registration' do
      tags 'registration'
      consumes 'application/json', 'application/xml'
      parameter name: :user, in: :body, schema: {
          type: :object,
          properties: {
              first_name: {   
              properties: 
              {
                  type: :string,
                  id: :integer
              }    
                },
          }, required: [ :first_name ]
      }
    end
  end
end

Answer 1

如果您只希望first_name 对象为user 对象，那么它应该是：

parameter name: :user, in: :body, schema: {
  type: :object,
  required: [:first_name],
  properties: {
    first_name: { type: :string }      
  }
}