SuperAPI AI 工具集

podium-rate-limit-survival

通用与其它

查看项目

更新于 10-15 23:28

技能介绍

用途:让 Podium 集成的出站调用在真实生产负载下存活,重点解决六类限流故障:429 级联耗尽每日配额、忽略 Retry-After 提示、无每日配额监控、端点间相互拖垮、下班前突发溢出、Webhook 入站放大出站调用。

主要能力:1) 令牌桶限流器,按文档上限 60 请求/分钟主动限速,把 429 级联转为有界排队;2) 解析 Retry-After 的整数秒与 HTTP-date 两种形式,并设最大等待上限(如 120 秒);3) 每日配额监控,用 Redis 原子 INCR + TTL 计数,在 70%/85%/95% 触发警告、告警、硬限流;4) 按端点族(conversations、contacts、reviews、locations、webhooks)隔离令牌桶,各桶速率之和等于全局上限;5) 突发平滑器,把 80 个评论请求从 30 秒摊到 120 秒;6) Webhook 放大核算,按事件类型估算放大倍数并在入口做准入控制。

使用方式:需先有可用的 podium-auth 集成(本技能不签发或刷新凭证,调用前通过 auth.get_token() 获取 Bearer token);Python 3.10+ 与 asyncio,推荐 aiolimiter 或基于 asyncio.sleep 自建令牌桶;每日配额计数推荐 Redis,单进程可用 SQLite。按顺序实现上述六部分,每部分对应一类故障。

适用场景:Podium 出站集成、Shopify 订单高峰触发的评论请求、Webhook 突发扇出等。

限制:文档未提供具体每日配额数值、各端点实际速率与放大倍数,需按自身集成实测调整;本技能不处理认证恢复,认证错误直接向上抛出;Node.js 实现需参考其 references/implementation.md。