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 时，它会选择所有其他操作（例如 Get、Put、Post 等），但 UI 中没有搜索操作的文档。我一直在谷歌搜索，但对于如何制作它以便搜索操作显示在 Swagger UI 中却一无所获。有什么想法吗？

谢谢！

Answer 1

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