How to have the same response format for 400 response raised from BadRequest and validations?-CodePudding

I have a DTO which is an input param for the API's POST endpoint.

The DTO has got data annotations and validation happens automatically. Following is an example:

{
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "traceId": "00-f14406a8950b1005234cc79298a79586-77222ebbed97e453-00",
    "errors": {
        "Email": [
            "The Email field is not a valid e-mail address."
        ]
    }
}

However, when I want to raise 400 response from the controller, using either of the following:

return BadRequest("some message")

This returns some message

Where as this: return BadRequest(new { message = "some message"}); returns:

{
    "message": "some message"
}

How to ensure that the same format is used throughout? Is there any in-built way to standardize.

CodePudding user response：

Create a base api controller as follows:

[ApiController]
public abstract class ApiControllerBase : ControllerBase
{        
    protected virtual IActionResult InvalidModelState() {
        return HttpContext.RequestServices.GetService<IOptions<ApiBehaviorOptions>>()
            .Value.InvalidModelStateResponseFactory(ControllerContext);
    }
}

And derive your api controllers from the ApiControllerBase. Whenever you want to add errors and use the same format of validation errors just add a ModelState.AddModelError("", "Your error message") then return InvalidModelState();.

CodePudding user response：

As per documentation - https://docs.microsoft.com/en-us/aspnet/core/web-api/?view=aspnetcore-6.0#default-badrequest-response

The ValidationProblemDetails type:

Provides a machine-readable format for specifying errors in web API responses.

Complies with the RFC 7807 specification.

To make automatic and custom responses consistent, call the ValidationProblem method instead of BadRequest.

ValidationProblem returns a ValidationProblemDetails object as well as the automatic response.