建议错误分层

  • 4xx: 客户端参数或权限问题
  • 5xx: 服务端异常
  • 429: 限流触发

重试建议

  1. 仅对可重试错误(429/502/503/504)启用重试。
  2. 使用指数退避: 1s, 2s, 4s。
  3. 重试上限建议不超过 3 次。
  4. 所有错误返回 request_id 便于追踪。

返回结构建议

{"code":"RATE_LIMIT","message":"too many requests","request_id":"abc123"}