我使用的是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)。在屏幕上记录了其他响应类型的任何地方都看不到。

最佳答案

xml 和[SwaggerResponse]不能同时使用。 标签将取消显示您的[SwaggerResponse]。尝试删除所有标签,您将在swagger ui中看到该模型。

关于api-doc - Swashbuckle SwaggerResponse不显示响应模型,我们在Stack Overflow上找到一个类似的问题:https://stackoverflow.com/questions/29696236/

10-09 07:25