跳到內容
Delivery API
在規劃採用某項功能之前,請先查看功能狀態。

參考

限制與錯誤

速率限制、大小限制,以及您的網站可能從 Atlas 收到的錯誤代碼。

本頁翻譯自英文。若內容有任何差異,以英文版為準。 閱讀英文版

範圍 限制
Delivery API 目前沒有每次請求的限制。請快取回應並使用 ETag;日後可能會加入限制
表單送出 每 10 分鐘:每個網站 300 次、每個表單 120 次、每個 IP 位址 12 次、每個訪客工作階段 6 次
聊天機器人對話 每個 IP 位址每 10 分鐘 10 個新對話
聊天機器人訊息 每個 IP 位址每 10 分鐘 40 則;每個對話 80 則
頁面瀏覽信標 每個 IP 位址與環境每分鐘 120 次
MCP(AI 代理程式) 預設每個連線每分鐘 120 次呼叫
Leads API 每把金鑰每分鐘 300 次請求
Core Web Vitals 每個環境每小時 3 次手動檢查

達到限制時,Atlas 會回應 429。請等候並以退避方式重試。

項目 限制
/routes 回傳的路由 5,000
每次請求的項目數 100(limit)
每個區域的區段數 60
單次表單送出的欄位數 30
聊天訊息 1,000 個字元
部署回報中的元件數 500
MCP 請求本文 3 MB
預覽連結有效期間 15 分鐘
已簽署媒體連結有效期間 15 分鐘
單次 CSV 匯出的潛在客戶 50,000
使用中的 Leads API 金鑰 每個環境 20 把
CRM 連線 每個環境 10 個
llms.txt 中的頁面 2,000

您的方案也決定網站、人員、儲存空間與語言的數量。

狀態 代碼 意義
401 CP_UNAUTHENTICATED 權杖遺失、錯誤、已過期或已撤銷
400 FILTER_INVALID 無法讀取項目的 filter 或 sort
403 ORIGIN_DENIED 瀏覽器請求來自未為該網站登錄的來源
403 CP_PRODUCTION_LOCKED Production 已開啟但尚無已簽署的正式發行版本,或該動作僅限 Development
409 SITE_ADDRESS_MISSING 該環境尚無網站位址
403 PREVIEW_INVALID 預覽連結無效
404 CP_NOT_FOUND 未知的環境,或該處沒有已發布內容
404 LOCALE_UNSUPPORTED 網站不支援該語言
404 FEED_NOT_EDITORIAL 摘要只適用於編輯型集合
409 CONVERSATION_FULL 聊天對話已達 80 則訊息
410 PREVIEW_EXPIRED 預覽連結已超過 15 分鐘
422 SUBMISSION_INVALID 表單欄位驗證失敗
400 SUBMISSION_REJECTED 表單送出被拒絕
428 BOT_CHALLENGE_REQUIRED 請完成 Turnstile 挑戰後重試
429 RATE_LIMITED 請求過多

您的網站應將任何 5xx 或逾時視為「Atlas 無法使用」,並提供其內建的備援內容。