Swashbuckle SwaggerResponse zeigt kein Antwortmodell

Question

Ich verwende die neueste Version von Swashbuckle 5.1.3 und bemerkte, dass es ein neues Attribut SwaggerResponse gibt, mit dem Sie einen Antworttyp für jeden Antwortcode dokumentieren können. Zum Beispiel:

(https://github.com/domaindrivendev/Swashbuckle/issues/175 < könnte sich als nützlich erweisen).

/// <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 
} 

Die erste Reaktion Klasse fein dokumentiert wird, sondern weiter nach unten, wo es eine Tabelle von "Response Messages" zeigt, das Antwortmodell (für 400 Bad Request) leer ist. Es wird nirgendwo auf dem Bildschirm angezeigt, wo der andere Antworttyp dokumentiert ist.

Answer 1

Die Antwort xml <> und [SwaggerResponse] werden nicht gleichzeitig verwendet. < Antwort> Tag unterdrückt Ihre [SwaggerResponse]. Versuchen Sie, alle Tag zu entfernen, und Sie sollten das Modell in swagger ui sehen.