Swashbuckle：Swagger UI：自定义 API 动作

Question

我们使用 Swashbuckle/Swagger 作为我们的 API 文档，通过 Nuget 安装。我们的 Web API 2 个控制器有一个搜索端点：

[HttpPost]
[AcceptVerbs("POST")]
[Route("api/v1/controllername/search")]
public IHttpActionResult Search([FromBody] SearchModel model)
{
    // Code here...
}

当我 运行 项目并导航到 Swagger UI 时，它会选择所有其他操作（例如获取、放置、Post、等...）但是 UI 中没有搜索操作的文档。我一直在谷歌搜索，但对于如何使搜索操作显示在 Swagger UI 中一无所知。有什么想法吗？

谢谢！

Answer 1

所以，这里的问题是 [HttpPost] 属性。删除该属性后，端点在 Swagger 中完美显示。