文档
邀请好友,多拿一次周额度重置。好友注册并使用即得 1 次重置(30 天内有效)· 其消费再拿最高 10% 现金返现。
+1 次重置生成链接

错误处理

按接口的真实信封和凭证失败语义处理。

模型标准 /v1 使用对应协议的原生错误格式;既有开放边缘、Java资金与控制台查询保留自己的业务信封。不要把全站错误都按同一JSON格式解析。保留请求标识、HTTP状态与业务机器码,日志不要写Key明文。

  • 401/403:确定无效、吊销、scope不足不能重试提权。会话过期按原登录旅程刷新或恢复订单页。
  • 503:身份/资金/provider依赖故障按提示与适用Retry-After重试,不能展示为0余额或无模型。
  • 409:幂等同键异载荷或合同冲突,无副作用;不要用新随机键绕过冲突。
  • 网络超时:不证明上游未执行。先查询原任务/订单或费用状态。

SDK HTTPError、NetworkError、BusinessError 与 CompliancePollError 按层分类。默认 POST 不自动重放;compliance写遇401不自动重放。缺最终usage时状态待核对,不等于免费。