细分错误码按业务模块分组，便于接入与排障。
| 码段 | 模块 | 用途 |
|---|---|---|
| 40001-40111, 40401-40402, 50011 | 认证模块 | 登录注册、验证码、邮箱验证码、密码重置/修改等。 |
| 40101-40301, 42901-42903, 50201, 50301 | 网关模块 | API Key 鉴权、余额扣费、速率限制、服务请求失败等。 |
| 40021-40028, 40302, 40411, 50021-50023 | 支付模块 | 创建支付会话、订单状态校验、取消订阅等。 |
| 错误码 | 名称 | 含义 | 建议处理 |
|---|---|---|---|
| 200 | 成功 | 请求处理成功。 | 读取 `data` 获取业务数据。 |
| 400 | 请求参数错误 | 参数不合法或业务校验未通过。 | 检查必填参数、取值范围与请求格式。 |
| 401 | 未授权 | 鉴权失败（未登录、缺少或无效 API Key）。 | 重新登录或传入有效的 `X-API-Key`。 |
| 402 | 余额不足 | 余额不足或调用次数已用完，无法完成本次调用。 | 请充值或升级套餐后重试。 |
| 403 | 无权限 | 没有访问权限或账户状态受限。 | 检查账户状态和接口访问权限。 |
| 404 | 资源不存在 | 请求的资源不存在。 | 检查 ID/订单号是否正确、数据是否存在。 |
| 429 | 请求过于频繁 | 触发每秒/每小时/月度限流。 | 降低请求频率，并使用退避重试。 |
| 500 | 服务器内部错误 | 服务端处理异常。 | 稍后重试；持续失败请联系支持。 |
| 502 | 服务暂时不可用 | 服务请求处理失败。 | 请稍后重试。 |
| 503 | 服务繁忙 | 系统繁忙或触发全局保护限制。 | 等待短时间后重试。 |
| 错误码 | 名称 | 含义 | 建议处理 |
|---|---|---|---|
| 40101 | 未登录会话 | 登录态缺失或失效。 | 重新登录后重试。 |
| 40102 | 缺少 API Key | 请求未携带 API Key。 | 通过 `X-API-Key` 或 Bearer Token 传入密钥。 |
| 40103 | API Key 无效 | 提供的 API Key 无效。 | 检查并更换有效 API Key。 |
| 40201 | 余额不足 | 余额不足或调用次数已用完。 | 请充值或升级套餐后重试。 |
| 40301 | 账户冻结 | 账户被冻结或受限。 | 联系支持恢复账户状态。 |
| 42901 | 每秒速率超限 | 超过每秒请求速率限制。 | 降低突发并使用退避重试。 |
| 42902 | 每小时速率超限 | 超过每小时请求速率限制。 | 降低调用频率。 |
| 42903 | 月度额度超限 | 达到月度调用上限。 | 升级套餐或等待下个计费周期。 |
| 50201 | 服务暂时不可用 | 服务请求处理失败。 | 请稍后重试。 |
| 50301 | 触发全局保护限制 | 系统触发全局限流保护。 | 短暂等待后重试。 |
| 错误码 | 名称 | 含义 | 建议处理 |
|---|---|---|---|
| 40001 | 图形验证码无效 | 图形验证码不正确或已失效。 | 刷新验证码后重试。 |
| 40002 | 需要图形验证码 | 当前操作必须提供图形验证码。 | 补充验证码参数后重试。 |
| 40003 | 邮箱已注册 | 该邮箱已存在账号。 | 直接登录或走找回密码流程。 |
| 40004 | 邮箱验证码无效 | 邮箱验证码错误或已过期。 | 重新发送验证码后重试。 |
| 40005 | 密码长度不足 | 密码长度不满足最小要求。 | 使用至少 6 位密码。 |
| 40006 | 令牌无效 | 重置密码令牌无效或已过期。 | 重新申请重置链接/令牌。 |
| 40007 | 套餐参数无效 | 套餐类型或套餐名称无效。 | 从 `/myapi/plans` 获取有效套餐后再下单。 |
| 40008 | 验证码发送冷却中 | 验证码发送过于频繁。 | 等待冷却时间后再请求。 |
| 40111 | 账号密码错误 | 邮箱或密码校验失败。 | 检查凭据后重试。 |
| 40401 | 邮箱不存在 | 邮箱对应的账号不存在。 | 检查邮箱或先注册账号。 |
| 40402 | 用户不存在 | 未找到对应用户记录。 | 检查登录状态与用户信息。 |
| 50011 | 邮件发送失败 | 发送验证码邮件失败。 | 稍后重试。 |
| 错误码 | 名称 | 含义 | 建议处理 |
|---|---|---|---|
| 40021 | 订单已过期 | 订单在支付前已超时。 | 重新创建订单。 |
| 40022 | 订单状态非待支付 | 订单当前不是待支付状态。 | 先查询订单状态再操作。 |
| 40023 | 订阅仅支持信用卡 | 订阅模式仅支持信用卡支付。 | 使用 `credit_card` 支付方式。 |
| 40024 | 不支持的支付方式 | 支付方式不在支持范围内。 | 选择平台支持的支付方式。 |
| 40025 | 订单非已支付订阅 | 仅已支付的订阅订单可取消。 | 确认订单已支付且为订阅模式。 |
| 40026 | 订单非订阅制 | 当前订单不是订阅订单。 | 检查订单计费模式后再取消。 |
| 40027 | 仅支持 Stripe 取消 | 取消订阅接口仅支持 Stripe 订阅。 | 使用 Stripe 订阅订单进行取消。 |
| 40028 | 缺少订阅 ID | 当前订单缺少订阅标识。 | 等待回调同步或稍后重试。 |
| 40302 | 资源无权限 | 当前资源不属于该用户。 | 使用本人账号下的资源。 |
| 40411 | 订单不存在 | 未找到对应订单记录。 | 检查 `order_no` 是否正确。 |
| 50021 | 创建支付会话失败 | 创建支付会话失败。 | 稍后重试或更换支付方式。 |
| 50022 | 当前渠道不支持取消 | 当前支付渠道不支持订阅取消。 | 使用支持的渠道或联系支持。 |
| 50023 | 取消订阅失败 | 取消订阅执行失败。 | 稍后重试，持续失败请联系支持。 |