构建错误信息

在网络请求响应错误的时候,返回统一的,结构化的错误信息。要包含一个机器可读的错误 id,一个人类能识别的错误信息 message, 根据情况可以添加一个url ,告诉客户端关于这个错误的更多信息以及如何去解决它。
例如:

  1. HTTP/1.1 429 Too Many Requests
  1. {
  2. "id": "rate_limit",
  3. "message": "Account reached its API rate limit.",
  4. "url": "https://docs.service.com/rate-limits"
  5. }

把你的错误信息格式文档化,以及这些可能的错误信息ids 让客户端能获取到.