SuperAPI AI 工具集

anima-webhooks-events

编程与开发

查看项目

更新于 10-15 22:42

技能介绍

用途:用 Figma Webhooks v2 检测已批准的设计变更,并将事件入队以触发 Anima 代码生成,构建事件驱动的设计到代码流水线。Figma 提供事件契约,本工作流不虚构 Anima 的 webhook API。

主要能力:注册 Figma 团队级 webhook;在接收端校验 passcode 后仅处理 FILE_VERSION_UPDATE 事件;通过队列异步触发 Anima 生成;支持限流、重试、死信队列与幂等去重;生成代码需经显式审批门才能合并或部署。

使用方式:先注册 webhook,命令为 curl -X POST "https://api.figma.com/v2/webhooks",携带 X-Figma-Token 与 JSON 体(event_type、context、context_id、endpoint、passcode、description)。接收端用 express 路由处理 /webhooks/figma,使用 crypto.timingSafeEqual 校验 passcode,非 FILE_VERSION_UPDATE 事件返回 200 跳过,否则入队并立即返回 200。

前置条件:团队级 Figma webhook 权限、公网可达 HTTPS 端点、passcode 存于密钥管理器;维护已批准 file key 与组件 node ID 的允许列表;持久化 event-id/version 存储、带重试与死信的队列、含合成设计数据的暂存工作区;限流预算、重放/重复策略及合并部署前的审批门。

错误处理:passcode 无效返回 400 且不入队;事件畸形、重复、过期或不在允许列表则安全确认并丢弃,保留去重审计回执;生成或质量检查失败按有界退避重试后进死信队列,不自动合并部署;触发限流时遵循提供方响应并施加队列背压,保持同一文件事件顺序;文件删除或权限撤销时停用生成,需所有者确认后再清理或重新注册。

限制:需团队级权限与公网端点;不得记录文件内容、触发者、令牌或完整载荷;失败重生成须保留上一已知良好版本;FILE_UPDATE 过于频繁,建议改用版本事件。