SuperAPI AI 工具集

api-rate-limiting-helper

编程与开发

查看项目

更新于 10-16 06:22

技能介绍

用途:为任意 API 设计完整的限流、配额与重试系统,适用于需要控制请求速率、防止过载、设计分级套餐或处理超限重试的场景。

主要能力:

  1. 限流算法选型。资料给出令牌桶(适合突发流量且保持平均速率)、漏桶(严格限速)、固定窗口(计数简单但有边界突刺问题)、滑动窗口日志(精确但耗内存)、滑动窗口计数器(精度与内存平衡)。建议 API 端点用滑动窗口计数器,流式/上传端点用令牌桶。
  2. 标准响应头:X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset、X-RateLimit-Policy 与 Retry-After。
  3. 429 响应体,包含 error、message、retry_after_seconds、limit、window、reset_at 等字段。
  4. 分层配额设计,资料列出 Free、Starter、Pro、Enterprise 四档的每分钟请求数、每日请求数、突发与并发数,并给出配额查询端点 GET /api/v1/account/quota 与 /api/v1/account/quota/history 及响应结构。
  5. 客户端重试逻辑:指数退避加抖动,优先读取 Retry-After 头;并列出可重试状态码(429、500、502/503、504)与不可重试状态码(400、401、403、404、422)。
  6. 断路器模式:CLOSED、OPEN、HALF-OPEN 状态转换,含失败率阈值与冷却期。
  7. 幂等键:用于可能重试的写请求,通过 Idempotency-Key 头与 X-Idempotent-Replayed 标识,缓存响应 24 小时。

使用方式:作为技能在对话中调用,用户在询问 API 限流、配额或重试时启用,输出上述设计内容。完成后会询问是否需要生成 API 文档,若已安装 API Documentation 技能则可继续,否则提示安装。

限制:资料未提供具体平台支持范围、收费与价格信息;实现细节(如存储与并发处理)暂未提供。