错误处理

SDK 将 HTTP、业务错误和 compliance 终态失败分层处理；写操作不会自动 401 重放。

错误层级

• HTTPError / NetworkError：基础传输失败。
• BusinessError：业务响应中的错误对象。
• CompliancePollError：轮询超时、终态失败或 step-up required。

重试原则

GET 读路径可安全刷新 token 后重放；compliance 写路径先确保 token fresh，遇到 401 直接抛错，不自动重放。调用方必须复用持久化的 Idempotency-Key。