SuperAPI AI 工具集

procore-rate-limits

通用与其它

查看项目

更新于 10-15 23:28

技能介绍

用途:该技能用于按 Procore 每次响应返回的头信息动态控制请求吞吐,而非硬编码请求数。Procore 会暴露最可能起约束作用的突发或小时窗口,失败请求与成功调用消耗同一额度。

主要能力:捕获 X-Rate-Limit-Limit、X-Rate-Limit-Remaining、X-Rate-Limit-Reset,并保留高负载响应的 Retry-After。在额度耗尽前降低调度并发,额度归零时暂停。遇到 429 等待重置时间并加抖动后恢复;遇到 503 遵循 Retry-After,不假设延迟。对安全读取按上限策略重试,对写入先对账或要求幂等设计。保护事件积压:快速确认 webhook,入队下游读取并排空,同时监控最早事件年龄与队列深度。

使用方式:需要集中式请求调度器、可观测的 worker 并发、持久队列和同步时钟;指标覆盖状态、路由、剩余额度、重置时间、重试与积压年龄。认证沿用现有 OAuth 2.0 Bearer 令牌与公司路由,不得为绕过限流更换凭证或把令牌与限流元数据一起记录。用 Read 和 Grep 检查调度代码、指标和头信息,Write 或 Edit 仅用于修改限流器、队列策略、测试或回执,不生成真实负载做限流测试。

限制:若速率头缺失,应保守降低并发并上报遥测丢失,不得凭空假定额度;写入重试安全性未知时停止自动重试并对账。输出包括头驱动节奏与重试策略、确定性限制与恢复测试、路由级指标,以及观测头、控制器决策、重试资格、下次调度时间与验证结果。