SuperAPI AI 工具集

figma-deploy-integration

设计与创作

查看项目

更新于 10-15 23:25

技能介绍

用途:将 Figma Webhook 接收器与设计 API 服务部署到生产平台,并配置密钥管理与健康检查。

主要能力:

  1. Vercel 部署 Webhook 接收器:用 vercel env add FIGMA_PAT production 与 vercel env add FIGMA_WEBHOOK_PASSCODE production 存储密钥,再执行 vercel --prod 部署;示例服务端函数校验 passcode(长度不等时先拦截,再用 crypto.timingSafeEqual 比较),并按 FILE_UPDATE、FILE_COMMENT、LIBRARY_PUBLISH 等事件类型处理。
  2. Cloud Run 部署设计令牌 API:提供 Dockerfile(node:20-slim、npm ci --omit=dev、PORT=8080),用 gcloud secrets create figma-pat --data-file=- 存 PAT,再 gcloud builds submit 与 gcloud run deploy,通过 --set-secrets 注入密钥,可设 --max-instances、--timeout。
  3. Fly.io 部署常驻 Webhook 服务:fly.toml 配置 internal_port、force_https、auto_stop_machines、min_machines_running 及 /health 检查;用 fly secrets set 设置 FIGMA_PAT 与 FIGMA_WEBHOOK_PASSCODE,再 fly deploy。
  4. 健康检查端点:调用 https://api.figma.com/v1/me 验证 Figma 连通性,返回状态、延迟与时间戳,失败返回 503。

使用方式:需准备生产环境 Figma PAT、安装对应平台 CLI(vercel、fly 或 gcloud),并在本地用 Figma API 测试通过后按步骤部署。

适用场景:Webhook 接收、设计令牌同步、Figma 连接型 Web 应用上线。

限制与错误处理:密钥名错误会导致运行时找不到密钥,可用平台 CLI 核对;Webhook 超时可先立即返回 200 再异步处理;冷启动延迟可用 Fly.io min_machines_running: 1 或 Cloud Run 最小实例缓解;PAT 过期需轮换。具体收费、价格与平台效果资料未提供。