API 验证错误格式

Question

1

{
  "errors": {
    "firstName": ["cannot be blank", "must be 10+ characters"],
    "lastName": ["cannot contain symbols"]
  }
}

2

{
  "errors": [
    { "path": "firstName", "message": "cannot be blank" }, 
    { "path": "firstName", "message": "must be 10+ characters" },
    { "path": "lastName", "message": "cannot contain symbols" }
  ]
}

你喜欢什么格式，为什么，它有什么优势？

Answer 1

我总是建议采用现有标准。有一个媒体类型application/problem+json 可能很适合这里。它的规范在这里https://datatracker.ietf.org/doc/html/draft-nottingham-http-problem-07，更像是您的第二个示例：为每个验证或其他问题提供一份报告。