用途:为 BambooHR 集成设计有界重试、背压与队列行为,避免把观测到的限流当作产品保证。官方来源未公布统一数值配额,因此不得编造配额。
主要能力:官方 Python SDK 对 HTTP 408、429、504、598 使用指数退避,起始 100 ms;重试次数可配置为 0 到 5,默认 1;提供 RateLimitExceededException 与请求 ID。503 表示服务不可用,但不在文档所述的自动重试集合内。
使用方式:先盘点共享同一租户身份的所有调用方、并发源、定时同步、Webhook 重放与手动任务;将操作分类为只读、带键幂等、条件安全或不可安全重试,变更类默认不自动重试。遇到 429 时,若存在有效 Retry-After 则遵循,否则使用带上限和抖动的指数退避,并限制总尝试次数与总耗时。408、504、598 仅对可安全重试的工作应用同一预算。集中管理每租户并发与队列上限,加入熔断器并分散定时全量同步。重试须复用同一租户绑定身份,不记录或重建令牌;OAuth 令牌过期允许一次刷新,认证失败不计入限流重试。
适用场景:BambooHR 集成中的限流处理、重试策略设计、队列与并发控制、可观测性建设。
限制:该技能不发送实时请求,也不调整账户的 BambooHR 配置;修改生产并发、重放队列中的 HR 操作或为变更启用重试前需审批;在读取确认当前状态前,不得重试状态不明的写入。输出应包含操作分类、可重试状态、最大尝试与耗时预算、延迟策略、Retry-After 处理、并发与熔断设计、遥测、测试证据及上线边界。