6
Sto usando l'ultima versione di Swashbuckle 5.1.3 e ho notato che c'è un nuovo attributo SwaggerResponse che consente di documentare un tipo di risposta per ciascun codice di risposta. Ad esempio:Swashbuckle SwaggerRisponsione non mostrando il modello di risposta
(https://github.com/domaindrivendev/Swashbuckle/issues/175 < potrebbe rivelarsi utile).
/// <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
}
La classe risposta iniziale è documentato bene ma più in basso dove si mostra una tabella di "Response Messages", il modello di risposta è vuota (per 400 richiesta). Impossibile vedere ovunque sullo schermo in cui è documentato l'altro tipo di risposta.