API 限流与重试策略

重试只适用于暂时性且可安全重放的失败。认证、资格和参数错误需要先修正，不能依靠重试恢复。

可重试

• 连接超时、临时 5xx 和明确要求稍后重试的响应。
• 登录态 POST 重试复用原 requestId。
• GET 每次都是新的提取，应由调用方限制重放。

不可自动重试

• 400 参数错误。
• 401 登录态失效。
• 403 实名或权限门禁。
• 407 代理认证失败和明确合规拒绝。
• 账户 API 令牌无效导致的 401，以及实名或权限门禁导致的 403。

退避

• 读取服务端提供的等待提示。
• 使用指数退避并加入随机抖动。
• 设置最大次数和总截止时间。

保护

• 对调用方、任务和目标分别限流。
• 白名单 OpenAPI 按令牌独立计数：查询 60 次/分钟，新增和删除分别 10 次/分钟。
• 无效令牌尝试另按来源 IP 限流；生产共享限流存储不可用时返回 503，不会放行请求。
• 批量响应为 10431 时只重试修正后的 failed_items，不要重放已经成功的项目。
• 熔断持续失败链路并进入人工检查。
• 监控重试率而不只看最终成功率。