用途:把 Attio 当前公布的速率限制转化为保守的客户端限流策略,避免把官方上限当作可用容量。
主要能力:按工作区、方法、端点拆分请求指标;实现独立的读、写令牌桶,均低于官方上限;加入按工作区队列、有界并发、抖动与背压;对 429 响应解析 Retry-After(可能是 HTTP 日期而非整数秒),否则使用带上限的指数退避;仅对幂等或显式幂等保护的工作、且仅对 429 或符合条件的瞬时 5xx 重试;在低于生产限制下做负载测试,记录吞吐、尾延迟、队列年龄与重试放大。
当前契约:Attio 公布全局上限为每秒 100 次读请求、每秒 25 次写请求;记录与条目查询端点还使用 10 秒窗口的评分预算,复杂过滤与排序消耗更多评分;429 可能返回 HTTP 日期格式的 Retry-After;限制可能变化且与其他工作区流量共享,上线前需重新核对官方指南。
使用方式:先用 Read、Glob、Grep 检查并发、队列、重试与分页;仅在需要复核官方限制与响应语义时用 WebFetch;在治理策略与回滚阈值明确后再用 Write 或 Edit。认证沿用现有最小权限 Bearer 令牌,按工作区凭据隔离治理状态,切勿在限流遥测中暴露令牌。
适用场景:需要稳定调用 Attio API 的集成、同步或批量写入任务。
限制:不得在未获服务负责人批准与回滚计划前提高并发、重放非幂等写入或丢弃队列工作;写入结果不明确时须先对账再重试;队列年龄超目标时应削减可选工作或暂停生产者,而非加大突发。输出应包含已验证限制、队列分区、桶设置、重试资格、最大重试年龄、负载测试证据与回滚阈值。