Error Response: { "message": "...", "description": "...", "errors": [ ... ] }

Topics: ASP.NET Web API
Jun 20, 2013 at 8:46 AM
Edited Jun 20, 2013 at 9:00 AM
Are you sure that "ModelState" key makes much sense in an error response message? Isn't it just a list of key/value pairs with error messages? We're building RESTful services in the goal in mind that it should be as much as easy to consume by an average developer out there, right? Maybe something like this would be less confusing for a general developer (who may not be familiar with .NET server side technologies):
{
    "message": "...",
    "description": "...",
    "errors": { ... }
}