限制與大小
請求太頻繁或檔案太大時的處理方式:429、413、一般請求及匯入封存檔的大小限制。
本頁內容
程式送出請求太頻繁時,伺服器可能要求稍後重試;一次傳送太多資料時,請求會被拒絕。以下說明處理方式。編輯器本身的限制見平台限制。
請求頻率
429 Too Many Requests 表示請求過於頻繁。重試前先等待;若再次被拒絕,就增加等待時間,例如從 1 秒增至 2 秒,再增至 4 秒。這稱為指數退避(backoff)。大量操作應分散執行,避免同時送出許多請求。
請求主體大小
一般 REST 請求的 JSON 主體大小限制為 2 MiB。超過時請拆成多次操作,例如分批匯入反應。
匯入主體大小
匯入有個別限制:反應及相關檔案的封存檔最多 64 MiB,含附件的對話歷史封存檔最多 256 MiB。上傳檔案本身和解壓縮後的資料總量都受限。超過時請拆成多次匯入。
超出限制
- 超出頻率限制 —
429,帶退避延遲重試。 - 主體超過允許大小 — 請求遭拒(
413或400,依端點而定);請縮減或拆分資料。
延伸閱讀
- 錯誤 —
429及其他狀態碼。 - 從 sambot 匯入 — 大型匯入套件。
- 互動式參考文件 — 特定端點的限制。