Swashbuckle 5.1.3 の最新バージョンを使用して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 の場合)。他の応答タイプが文書化されている画面のどこにも表示されません。