用途:优化 Figma REST API 的使用成本,减少不必要的请求,使调用量保持在套餐限额内,避免过早升级套餐。
主要能力:按套餐层级与席位类型理解速率限制(Starter/Professional/Organization/Enterprise,Full、Collab、Viewer 席位限额不同,Variables API 仅 Enterprise 可用);通过 FigmaUsageTracker 记录端点、时间戳与是否命中缓存,输出总调用数、缓存命中率与按端点分组报告;用 depth=1 浅层获取文件、将多个 node ID 合并为单次 /nodes 请求、用 Webhook 替代轮询、缓存图片 URL(有效期 30 天)、先查 lastModified 再决定是否拉取完整文件;提供月度用量汇总查询,统计请求数、唯一文件数、缓存命中率、错误率与 Top 端点。
使用方式:需已有可用的 Figma 集成与请求日志,了解当前调用量,并能访问 Figma 管理设置查看套餐详情。示例命令:curl -s -H "X-Figma-Token: ${FIGMA_PAT}" "https://api.figma.com/v1/files/${FIGMA_FILE_KEY}?depth=1"。轮询架构每文件每天约 2880 次调用,改用 Webhook 后可降至约 10–50 次。
适用场景:分析请求量、削减冗余调用、选择合适套餐或做容量规划。
限制:Variables API 需 Enterprise,否则返回 403,可改用所有套餐免费的 styles API;速率限制按用户每分钟计算;具体价格与限额数值请以 Figma 官方文档为准,本资料未提供。