7

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

4

1 回答 1

5

xml <response> 和 [SwaggerResponse] 不会同时使用。<response> 标签会抑制你的 [SwaggerResponse]。尝试删除所有标签,您应该会在 swagger ui 中看到模型。

于 2015-04-23T21:52:16.280 回答