错误

​

错误结构

{
  "errors": [
    {
      "message": "Offer out of stock",
      "extensions": {
        "code": "GC-0009",
        "path": ["purchaseGiftCard"],
        "requestId": "req_01H...Offer out of stock",
      "code": "GC-0009",
      "path": ["purchaseGiftCard"]
    }
  ]
}

• AUTH-* — 认证与令牌问题
• BS-* — 通用业务 / 校验错误
• GC-* — 礼品卡操作
• VC-* — 虚拟卡操作

​

领域错误代码

​

故障排查

1. 检查 AUTH-* 的 scope。 这类问题几乎总是因为令牌未包含所需 scope；请重新签发令牌。
2. AUTH-0002在重试 GC-* 之前先重新查询。 优惠与库存变动频繁——拉取最新优惠后再重试。
3. 在重试业务错误前先重新查询。 GC-0009（库存）等表示外部状态已变化——不要用过期数据重试不要重试校验错误。 带有类似 4xx 语义的 VC-* 和 BS-* 代码在你修正输入或余额之前，重试会得到相同失败。
4. 对瞬时服务器错误使用退避与抖动重试，对 5xx / 网络错误使用抖动重试。 涉及资金流动的变更具备去重能力；参见 幂等性。