Swashbuckle: Swagger UI:自定义API动作

本文关键字:API 动作 自定义 UI Swagger Swashbuckle | 更新日期: 2023-09-27 18:13:17

我们使用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。任何想法吗?

谢谢!

Swashbuckle: Swagger UI:自定义API动作

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