跳转到主要内容
系统级错误由平台自身产生，常见于账户状态、令牌状态、权限与策略等场景。此类错误会返回固定格式的 JSON，便于程序统一处理。

​
固定错误格式

{
  "error": {
    "message": "Token is expired.",
    "type": "forbidden",
    "source": "system",
    "details": {
      "request_id": "2026010914011404810445",
      "note": "This error was generated by the system, not from any upstream provider."
    }
  }
}
字段说明：
  • error.message：可读错误信息
  • error.type：错误类型（用于程序分支处理）
  • error.source：固定为 system
  • error.details.request_id：请求 ID（排查用）

​
常见触发场景

  • 账户余额不足
  • 令牌过期 / 被禁用 / 不可用
  • 权限不足或策略拦截

​
如何识别

查看响应头： 
Poixe-Error-Source: system
Poixe-Request-Id: <request_id>

​
处理建议

  • 余额相关：检查账户余额与令牌状态
  • 令牌相关：确认是否过期/被禁用，并更新配置
  • 持续无法定位：携带 Request ID 联系团队