错误与重试

状态码

400 参数或业务规则错误；401 Key 无效；403 权限不足或尚未网页登录开通；404 资源不存在；409 幂等冲突或执行结果待核实；410 功能已下线；413 请求超限；429 限流；500 内部错误；503 认证服务不可用。

429 按 Retry-After 等待。503 可使用相同 Idempotency-Key 重试；身份校验失败时不会开始业务操作。不要在日志或报错反馈中附上 Key。

写入重试与待核实结果

Idempotency-Key 使用 16–80 位字母、数字、下划线或连字符。相同用户、空间、方法、路径与 Key 的请求，会返回第一次已完成的结果；内容不同返回 idempotency_conflict。

服务先持久化请求回执，再执行写入或外部操作。进程中断或无法确认结果时返回 operation_unresolved，不自动重跑，以免重复赠送权益或创建收支。

遇到 operation_unresolved，请保留 receiptId 和 requestId，先由管理员核实业务结果，不要更换 Key 再次提交。