Пример значения массива Rails Grape swagger отображается как объект

Question

У меня есть вложенный массив на моем API-интерфейсе rails.

      expose(
      :users,
      documentation: {
        type: Array,
        desc: 'The pickups and deliveries for specific tours'
      },
      using: Fleetdog::Entities::Users
    )

Но когда я посещаю страницу API-документов, значение примера представляет собой хэш, а не массив.

      example value
{ id: 'string',
users: {
  id: 'string',
  name: 'string'
}

Это как виноград должен работать?

Answer 1

Изучив источники , я нашел вариантis_arrayи это работает:

      expose(:projects, documentation: { type: Fleetdog::Entities::Project,
                                   is_array: true,
                                   desc: 'Projects' }) do |query|
  Fleetdog::Entities::Project.represent(
    Queries::Projects.call(query: query)
  )
end

=>

      "projects": [
    {
      //...
    }
  ]