Swashbuckle больше не обрабатывает документацию HTML Swagger

Question

У меня есть методы веб-сервиса, которые возвращают один и тот же HTTP-ответ по разным причинам, например, 400 Bad Request для разных качеств размещенных данных. Я использую Swashbuckle для создания документации Swagger API.

До недавнего времени я использовал элементы HTML для документирования ответов, чтобы перечислять различные причины для одного и того же HTTP-ответа. Пример:

... 
/// <response code="400"><ul> 
/// <li>New member model missing.</li> 
/// <li>Account name missing.</li> 
/// <li>Password missing.</li> 
/// </ul></response> 
/// <response code="409"><ul> 
/// <li>Data consistency issue.</li> 
/// </ul></response> 
... 

В то время как это используется для работы в порядке, так как сравнительно недавно обновление Swashbuckle HTML, не отображается должным образом больше, и вместо этого, я получаю HTML-элементы отображаются как текст. Пример результата:

Листинг ответов несколько раз не работает. У кого-нибудь есть рабочее решение для этого?

Answer 1

Если он работал, но не больше, это, вероятно, проблема с Swashbuckle. Попробуйте использовать более старую версию пакета, чем та, которую вы используете.

См. Swashbuckle on NuGet для публикации всех версий (общедоступно).

Если вы обнаружите, что последняя версия действительно нарушает эту функцию, сообщите об ошибке разработчикам. Правильное место для перечня вопросов относится к Github:

• domaindrivendev/Swashbuckle.AspNetCore для ASP.NET Core. Основная версия 6 или выше.
• domaindrivendev/Swashbuckle для ASP.NET 4.x. Основная версия 5 или ниже.