SuperAPI AI 工具集

figma-rate-limits

编程与开发

查看项目

更新于 10-15 23:25

技能介绍

用途:处理 Figma REST API 的速率限制,在遇到 429 错误、实现重试逻辑或优化 API 调用时使用。

主要能力:Figma 采用漏桶算法限流,桶满时返回 429 并附带 Retry-After 头。限制因套餐层级、席位类型和端点层级而异。技能覆盖端点分层(Tier 1 如 GET /v1/files、GET /v1/images 配额较高;Tier 2 如评论、本地变量配额中等;Tier 3 如团队组件、样式配额较低),以及 429 响应头 Retry-After、X-Figma-Plan-Tier、X-Figma-Rate-Limit-Type、X-Figma-Upgrade-Link 的含义。

使用方式:实现指数退避重试,读取 Retry-After 头决定等待时长并加入抖动;对 5xx 使用无 Retry-After 的指数退避。用 p-queue 建立请求队列控制并发(如 concurrency 3、每秒最多 5 个请求)。用监控类记录请求时间窗,接近保守估算上限时主动延迟。批量节点请求将多个 node ID 合并为一次调用(batchSize 默认 50),减少总请求数。

适用场景:Figma REST API 集成、批量拉取文件与节点、评论与图片导出等需要控制调用频率的场合。

限制:具体配额数值未在资料中给出,仅说明按套餐、席位和端点层级变化;批量过大可能返回 400,需将批次降至 50 个 ID;反复 429 需记录告警并延长退避。安全配置参见 figma-security-basics。