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

Question

我的大摇大摆的ui显示“参数内容类型”，其中包含各种条目:“application/json-patch+json”、“text/json”、“application/json”和“application/*+json”。

我只想要“application/json”。

在repo上有一个类似的未解决的问题，它使用了这个可视化（旧的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/en-us/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( MediaTypeNames.Application.Json )] // "application/json"
    [Produces( typeof(MyResponseDto) ) ]
    public async Task<IActionResult> Post( [FromBody] MyRequestDto dto )
    {
        // 
    }
}