2015-04-17 5 views
6

Я использую последнюю версию 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). Невозможно увидеть нигде на экране, где документирован другой тип ответа.

ответ

3

Ответы xml <> и [SwaggerResponse] не используются одновременно. < response отменит ваш [SwaggerResponse]. Попробуйте удалить все теги, и вы должны увидеть модель в swagger ui.

 Смежные вопросы

  • Нет связанных вопросов^_^