错误处理

ZTProxy API 使用 HTTP 状态码和 JSON 响应体共同表示请求结果。业务失败通常会返回非 0 code，并带有中文 message 或 msg。

常见格式

{
  "code": 401,
  "message": "未提供认证令牌",
  "data": {}
}

{
  "code": 400,
  "msg": "目标用户余额不足",
  "data": {}
}

FastAPI 参数校验错误可能使用标准 detail 字段：

{
  "detail": [
    {
      "loc": ["body", "duration"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}

HTTP / Code	提示	含义	处理方式
`401`	`未提供认证令牌`	未携带 Bearer Token。	添加 `Authorization: Bearer <token>`。
`401`	`无效的认证令牌`	Token 无效或过期。	重新登录。
`401`	`邮箱或密码错误`	登录失败。	检查用户名和密码。
`403`	`没有创建用户的权限`	当前用户无权创建用户。	使用管理员或代理商账号。
`403`	`只能为下级用户创建订单`	代理商为非下级用户下单。	使用该代理商名下的用户。
`400`	`目标用户余额不足`	余额低于订单金额。	充值或降低订单金额。
`404`	`用户不存在`	目标用户不存在。	检查 `userId`。
`500`	`创建订单失败`	创建订单时后端异常。	检查参数后重试；持续失败请联系支持。