Figma 方案與席位會如何影響 Snapside 歷史記錄？

連結 Figma 後，如果設計修改沒有馬上出現在 Snapside，你可能會想是不是哪裡出了問題。影響收集速度的因素之一，是 Figma API 的呼叫上限。

簡單來說，這個上限決定 Snapside 可以多常向 Figma 查詢檔案的最新狀態。

每月 20 次請求，就只能有 20 筆時間軸記錄嗎？

不一定。檔案請求次數和時間軸記錄筆數是兩回事。

一次檔案請求可以同時看到按鈕文字、顏色和間距等多處變更。第一次連線時，Snapside 也需要先取得一份檔案狀態，作為之後比對的基準。時間軸還可能把短時間內連續發生的修改放在一起顯示。

查看已儲存在 Snapside 的記錄，也不等於再次從 Figma 取得檔案。上限較低會讓新狀態收集得比較慢，但不會限制已儲存的記錄數量。

方案和席位有什麼不同？

Starter、Professional、Organization、Enterprise 是團隊或組織使用的方案；View、Collab、Dev、Full 則是分配給個別使用者的席位。

Figma 會同時參考使用者席位、API 請求類型，以及檔案所屬方案來套用限制。在其他組織擁有 Full 席位，不代表 Starter 空間裡的檔案也能使用相同上限。Figma 說明中心

在付費方案使用 Dev 或 Full 席位時，Figma 列出的 Tier 1 檔案內容請求上限如下：

這是請求上限，不代表 Snapside 會以這個頻率同步，也不代表每次請求都會新增一筆記錄。Figma REST API 文件

View 與 Collab 席位的檔案內容請求則按月限制。不過，截至 2026 年 10 月 6 日，Figma 官方資料中的數字並不一致：開發者文件表格寫著所有方案每月最多 20 次；說明中心表格則列出 Starter 每月最多 20 次、付費方案每月最多 6 次。開發者文件內文的範例也提到每月 6 次。Figma 並指出，實際上限可能依請求量而更低。

因此，不能保證每位使用者每月都能請求 20 次。遇到限流時，Snapside 會依照 Figma 回傳的重試時間安排後續處理。開發者文件、說明中心

Snapside 使用者之間會共用上限嗎？

對 Snapside 這類 OAuth 應用，Figma 會按使用者、方案和應用分別計算上限。其他 Snapside 使用者用完自己的額度，不會消耗你的額度。不過，也不要假設同一方案下的每個檔案都有各自獨立的月額度。Figma 限額說明

達到上限時，Snapside 會怎麼處理？

收到檔案變更通知後，Snapside 會把工作排入佇列，取得檔案並與上次儲存的狀態比較。如果 Figma 回傳限流，Snapside 會等待，並在指定時間後再次嘗試。