用途:围绕 Figma 数据 API 提供评论、版本历史与用户信息的处理规范,重点在敏感数据脱敏与隐私合规。
主要能力:通过 REST 接口读取与发布评论(支持 as_md=true 获取 Markdown 富文本、对评论添加 emoji 反应);获取文件版本历史并支持游标分页遍历;读取当前认证用户信息;对 email、img_url、access_token、refresh_token 等字段做日志脱敏;按数据敏感度分级(public/internal/pii)给出处理方式;设置缓存过期与清理策略。
使用方式:需配置 FIGMA_PAT,并具备 file_comments:read/write、file_versions:read 等作用域。请求头使用 X-Figma-Token。示例:curl -s -H "X-Figma-Token: ${FIGMA_PAT}" "https://api.figma.com/v1/files/${FIGMA_FILE_KEY}/comments?as_md=true"。版本分页通过 pagination.next_page 拼接 before 参数继续请求。
适用场景:需要同步 Figma 评论、追踪版本变更、在日志或存储中处理 Figma 用户数据时。
限制:403 通常因缺少 file_comments:read 作用域;新文件可能无版本历史,需先在 Figma 创建命名版本;图片导出 URL 30 天后过期,不应长期缓存;评论内容可能含 PII,存储前需扫描。企业访问控制另见 figma-enterprise-rbac。