用途:为公共 API 设计对外发布的限流策略。关注“限什么、怎么告知”,不涉及由哪个网关或中间件执行。核心目标是公平访问、防止单一调用方耗尽资源影响他人,把限流当作关于公平性、可扩展性与用户体验的策略决策。
使用方式:先批量提出澄清问题,答案会驱动后续步骤:REST、GraphQL 或两者;是全新设计还是已有强制限流(若已有,对比实际执行值与文档值,差异是首要发现);现有或计划中的消费者层级,企业客户是否已要求更高上限;滥用压力大小;是否出现过单一客户拖慢他人;是否多区域部署(各区域独立限流会把真实全局吞吐乘以区域数,公布的限流必须声明作用范围);边缘/网关已能输出什么;交付期限、是一次性修复还是长期合同、以及人力上限。
主要步骤:1)按范式选择计量模型,二者不可混用:REST 计请求数,GraphQL 按成本点数计价并公布成本公式;同时存在时分别发布并说明是否共享额度。算法默认令牌桶(桶深即突发、补充速率即持续额度),内部或低风险限制可降为固定窗口,对抗性抓取压力下升级为滑动窗口,突发是威胁时选漏桶;发布策略中应描述行为而非只写名称。2)设计层级:把突发与持续写成两个明确数字,不合并;键的选择随层级变化(匿名按 IP、认证按用户/令牌、付费按 API 密钥或组织、内部按服务身份);昂贵操作单独划额度;次级滥用防护可以存在但必须文档化其信号方式;测试/沙箱是否单独分层需明确决定。3)公平与租户隔离:租户级总量上限、租户内单用户限额、按端点类的小额度;硬性悬崖过狠时改用加权共享;成熟形态是纵深防御,可同时运行请求速率、并发、负载卸载等限制器,并说明负载卸载与限流的区别。4)选择响应头系列:默认遗留三件套 X-RateLimit-Limit/Remaining/Reset,并明确 Reset 语义;边缘能低成本输出 IETF 结构化字段时可同时输出两套;仅输出 IETF 字段会破坏现有客户端;响应头只是提示,不是保证;完全不发此类头(如 Stripe)仅在同时提供内置重试的 SDK 时可行,且需在文档中说明是有意选择。5)限流响应:REST 一律返回 HTTP 429(RFC 6585)并带 Retry-After。
限制:资料未提供具体企业价格与部署步骤;涉及的具体限流数值、定价、效果均为示例引用,非本工具保证。