限制與大小

為確保平台穩定運行，API 對請求頻率和傳輸資料大小設有限制。

請求頻率

超過允許的請求頻率時，伺服器回傳 429 Too Many Requests。正確的處理方式是採用指數退避策略（backoff）重試：逐漸增加重試間隔，不要密集地連續發送請求。請將大量操作分散在時間上，並以單一 Token 依序執行，而非並行爆發。

請求主體大小

一般 REST 請求的 JSON 主體大小限制為 2 MiB。這對任何反應設定、集合及設定資料都已足夠。若主體超過限制，請分批執行（例如分批匯入反應）。

匯入主體大小

匯入端點針對大型套件設計，有獨立的較高限制：資料匯入最高 64 MiB，含內嵌媒體的匯入最高 256 MiB。若套件更大，請拆分為多次匯入。

超出限制

  • 超出頻率限制 — 429，帶退避延遲重試。
  • 主體超過允許大小 — 請求遭拒（413 或 400，依端點而定）；請縮減或拆分資料。

延伸閱讀