Я использую последнюю версию Swashbuckle 5.1.3 и замечаю, что есть новый атрибут SwaggerResponse, который позволяет документировать тип ответа для каждого кода ответа. Например:Swashbuckle SwaggerResponse не показывает модель ответа
(https://github.com/domaindrivendev/Swashbuckle/issues/175 < может оказаться полезным).
/// <summary>
/// Lovely.
/// </summary>
/// <param name="blah">Blah blah blah.</param>
/// <returns>Something special.</returns>
/// <response code="200">OK very nice.</response>
/// <response code="400">Invalid request.</response>
[SwaggerResponse(HttpStatusCode.OK, "A", typeof(Foo))]
[SwaggerResponse(HttpStatusCode.BadRequest, "B", typeof(Bar))]
public IHttpActionResult Get(string blah)
{
// Some code
}
Начальный класс ответа документирован хорошо, но дальше вниз, где он показывает таблицу "Response Messages"
, модель ответа пуста (400 Bad Request). Невозможно увидеть нигде на экране, где документирован другой тип ответа.