Как построить модель с описанием в чванстве?

Question

Я хочу построить модель с описанием в swagger, как в 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 }      
  }
}