Swashbuckle SwaggerResponse没有显示响应模型

时间:2015-04-17 10:07:03

标签: api-doc swashbuckle

我使用的是最新版本的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)。无法在屏幕上看到记录其他响应类型的任何位置。

1 个答案:

答案 0 :(得分:4)

xml&lt; response&gt;并且[SwaggerResponse]不会同时使用。 &LT;响应&GT; tag会压制你的[SwaggerResponse]。尝试删除所有标记,你应该在swagger ui中看到模型。