如何使用Swashbuckle设置“参数内容类型”？

Question

我招摇用户界面会显示“参数的内容类型”与各条目："application/json-patch+json"，"text/json"，"application/json"，和"application/*+json"。

我只想要"application/json"。

回购上有一个类似的未解决问题，它使用以下视觉效果（旧版ui，但思路相同）：

有什么办法可以设置这个吗？

Swashbuckle.AspNetCore版本4.0.1
Swashbuckle.AspNetCore.Filters版本4.5.5

Answer 1

使用[Produces]和[Consumes]属性。Swashbuckle（以及其他类似NSwag的对象）会将其转换为适当的Swagger文档。

该[Consumes]属性的构造函数的第一个参数是String contentType：

public ConsumesAttribute ( string contentType, params string[] otherContentTypes );

https://docs.microsoft.com/zh-cn/dotnet/api/microsoft.aspnetcore.mvc.consumesattribute.-ctor?view=aspnetcore-2.2#Microsoft_AspNetCore_Mvc_ConsumesAttribute__ctor_System_String_System_String___

像这样：

[ApiController]
public class MyController : ControllBase
{
    [HttpPost( "/foo/bar" )]
    [Consumes( "application/json" )]
    [Produces( typeof(MyResponseDto) )
    public async Task<IActionResult> Post( [FromBody] MyRequestDto dto )
    {
        // 
    }
}