错误处理
按接口的真实信封和凭证失败语义处理。
模型标准 /v1 使用对应协议的原生错误格式;既有开放边缘、Java资金与控制台查询保留自己的业务信封。不要把全站错误都按同一JSON格式解析。保留请求标识、HTTP状态与业务机器码,日志不要写Key明文。
- 401/403:确定无效、吊销、scope不足不能重试提权。会话过期按原登录旅程刷新或恢复订单页。
- 503:身份/资金/provider依赖故障按提示与适用Retry-After重试,不能展示为0余额或无模型。
- 409:幂等同键异载荷或合同冲突,无副作用;不要用新随机键绕过冲突。
- 网络超时:不证明上游未执行。先查询原任务/订单或费用状态。
SDK HTTPError、NetworkError、BusinessError 与 CompliancePollError 按层分类。默认 POST 不自动重放;compliance写遇401不自动重放。缺最终usage时状态待核对,不等于免费。