Мы уже некоторое время используем Swashbuckle в ASP.NET Core и обновляем, когда выпускаются более новые версии. Мы заметили разницу при переходе к последнему выпуску, который использует объектную модель Microsoft для анализа и записи документов OpenApi 2.0.
До переключения параметр body ранее был указан в списке параметров. После переключения параметр тела указывается в конце списка параметров.
Мы используем другие инструменты для генерации кода на основе этого документа OpenApi. Некоторые из этих инструментов сталкиваются с проблемами, поскольку они предполагают упорядочение параметров.
Определяет ли OpenApi / Swagger какой-либо порядок по параметрам? Мы пытаемся определить, является ли этот документ неправильным или использованные нами инструменты были сделаны с неверными предположениями.