用途:为 Figma REST API 集成失败提供快速事件响应流程,覆盖分诊、缓解与事后复盘,适用于 Figma 集成宕机、报错或事后分析场景。
主要能力:提供五步流程。第一步快速分诊(前5分钟),用脚本检查 Figma 服务状态、令牌有效性、已知文件可读性与限流响应头;第二步决策树,按 403、429、404、500/503 及网络错误分类定位原因;第三步即时缓解,针对令牌过期给出 GitHub Actions、Cloud Run、Fly.io 的密钥更新命令,针对限流提供紧急模式跳过非关键调用,针对服务端故障提供缓存回退;第四步沟通模板(Slack 内部通知与外部说明);第五步事后复盘模板,含时间线、根因与行动项。另附错误处理表与分诊示例。
使用方式:需具备应用日志与指标访问权限、用于健康检查的 Figma PAT、沟通渠道(Slack、PagerDuty)。运行分诊脚本前设置 FIGMA_PAT 环境变量,并准备 FIGMA_FILE_KEY。示例命令:curl -s -o /dev/null -w '%{http_code}\n' -H "X-Figma-Token: ${FIGMA_PAT}" https://api.figma.com/v1/me;gh secret set FIGMA_PAT --body "figd_new-token-here";fly secrets set FIGMA_PAT=figd_new-token。
适用场景:设计令牌同步失败、资源导出失败、Figma 集成报错等事件的应急处理与复盘。
限制:资料未提供具体收费、价格或平台支持范围;部分缓解代码为示例片段,需结合自身环境调整;缓存回退数据可能过期,需定期刷新缓存。