错误码

本文档列出了 API 返回的常见错误代码及其对应的业务含义，以便您在程序中进行快速判断和错误处理。

标准 HTTP 错误码

状态码	名称	说明与排查建议
400	Bad Request	请求参数验证失败（如缺漏必填项、格式错误等）。
401	Unauthorized	未授权。未提供有效的 API Key，或者您的 API Key 已被禁用。请前往控制台确认您的密钥状态。
403	Forbidden	权限不足，或请求被拒绝（如余额不足、域名已被他人绑定等业务规则限制）。
404	Not Found	请求的接口路径或资源（如指定 ID 的记录）不存在。
429	Too Many Requests	请求频率超限。请参考限流与频率控制规范，并实施指数退避重试。
500	Internal Error	服务器内部错误。通常是数据库或系统级异常，请联系技术支持。
503	Service Unavailable	服务不可用。通常是因为后端的外部依赖项（如支付网关节点、AI 分析服务等）处于维护中或未配置。

HTTP 401 报错示例

{
  "success": false,
  "msg": "登录已失效或凭证无效"
}

HTTP 429 报错示例 (限流)

{
  "success": false,
  "msg": "请求过于频繁，请稍后再试",
  "retry_after": 60
}