用途:为 Anima API 的代码生成请求实现限流,适用于批量生成组件、处理速率限制错误或优化 API 调用。
主要能力:通过 FigmaRestApi 的结构化回调 onRateLimited 处理 Figma 速率限制,回调提供 retryAfter、figmaPlanTier、figmaRateLimitType;用 figmaRateLimitMaxWait 为每次生成绑定最大等待时间(1–180 秒,默认 60);对 Anima 生成配额按账户合同处理,不推断具体数值。
使用方式:安装固定版本 SDK,在运行时密钥管理器或注入环境中存放 ANIMA_TOKEN、FIGMA_TOKEN、FIGMA_FILE_KEY,并确认令牌仅具备所需作用域。定义 Figma 文件与节点 ID 白名单、有界批大小、最大重试预算和批准的输出目录。示例中通过 new FigmaRestApi({ defaultOptions: { token, onRateLimited } }) 配置,再以 anima.generateCode({ fileKey, nodesId, figmaRateLimitMaxWait, settings }) 调用。
限制与注意:不要围绕同一请求再加一层不协调的重试循环;401/403、无效节点或文件参数、策略拒绝不重试;仅对有限的瞬时 5xx 和网络故障重试,并限制次数与总耗时。超时、进程重启和部分写入视为不确定结果,提交前检查请求指纹或缓存,原子写入并隔离不完整文件。日志与回执可含计数、状态类别和哈希,但不得含令牌、设计内容、用户标识或生成源码。并发或配额设置变更需人工批准。资料未提供具体配额数值、价格或平台支持范围。