用途：这是一份 Figma REST API 集成的生产就绪检查清单，用于将 Figma 集成部署到生产、准备上线或审计现有集成时逐项核对。
主要能力：按七个步骤组织。一、认证与密钥：PAT 存入密钥管理器而非环境文件，使用最小必要权限（如 file_content:read 而非 files:read），跟踪 PAT 有效期（最长 90 天）并设置轮换提醒，测试 OAuth 刷新令牌流程，开发/预发/生产使用不同令牌，令牌不得出现在客户端代码或 git 历史中。二、错误处理：处理全部 HTTP 状态码（400、403、404、429、500），429 时遵守 Retry-After 头，瞬时错误使用带抖动的指数退避并设最大重试上限，Figma 不可用时优雅降级，日志不得泄露令牌。三、限流：请求队列控制并发（最多 3-5 个），单次请求批量节点 ID（每次最多 50 个），对高频访问文件做响应缓存（TTL 60-300 秒），主动限流监控，避免无延迟的紧密循环。四、监控与健康：提供健康检查端点（调用 https://api.figma.com/v1/me，超时 5 秒），对持续 429（>5/分钟）、403（令牌过期）、P95 延迟 >5 秒告警，仪表盘跟踪请求量、错误率与延迟。五、数据处理：图片导出 URL 视为临时（30 天后过期），未经用户同意不存储 Figma 中的 PII，文件数据按合适 TTL 缓存，大文件响应流式处理。六、Webhook：使用 HTTPS 端点，每次传入验证 passcode，处理重复投递的幂等性，5 秒内返回 200 并异步处理，失败进入死信队列。七、上线前预检：提供 bash 脚本，用 curl 检查令牌有效性（期望 200）、文件可访问性（?depth=1，期望 200）以及 Figma 状态页。
使用方式：按清单逐项核对，上线前运行预检脚本 ./scripts/figma-preflight.sh，输出中每行对应一个检查步骤，失败项提示需重新打开对应章节。
适用场景：部署 Figma 集成到生产、上线准备、集成审计。
限制：资料未提供具体收费、价格、平台支持范围或效果数据；清单内容为通用最佳实践，实际阈值与配置需结合自身环境调整。