登入開始免費試用
easyCoexistence 官方 API

Facebook Graph API 速率限制:錯誤 4、17、32、613 及 80001

Facebook 的 Graph API 會為專頁或系統用戶的存取權杖,在滾動 24 小時內每名有互動的用戶提供 4,800 次 Pages API 呼叫。超出上限時,它會返回錯誤 4(應用程式請求次數已達上限)、17(用戶請求次數已達上限)、32(專頁請求次數已達上限)、613(此 API 的呼叫次數已超出速率限制)或 80001(此專頁帳戶的呼叫次數過多)。請停止呼叫,然後逐步恢復。

easyCoexistence 以每個已連接專頁自身的權杖呼叫該專頁,並透過 Meta 的 Webhook 接收其動態活動、提及及訊息,如你需要,可轉發至你的端點,因此無需由任何程式輪詢專頁。

4

請求中所用權杖所屬的應用程式已達速率限制時的錯誤代碼。

17

請求中所用權杖所屬的用戶已達速率限制時的錯誤代碼。

32

用於 Pages API 請求的權杖所屬用戶或應用程式已達速率限制時的錯誤代碼。

613

自訂速率限制的錯誤代碼;子代碼 1996 表示 Meta 注意到該應用程式的請求量出現不一致的情況。

80001

使用專頁或系統用戶存取權杖進行專頁呼叫時的 Business Use Case 錯誤代碼。

4,800 × engaged users

使用專頁或系統用戶存取權杖時,每個滾動 24 小時可進行的 Pages API 呼叫次數。

各項速率限制錯誤代碼是什麼意思?

每個代碼指出已達到的限制,而請求中的權杖決定適用哪一項。Meta 的速率限制指南說明每個代碼的含義,其錯誤參考則列出隨附的錯誤訊息。以下逐一列出,並附上 Meta 所用的訊息:

Meta's messageWhat reached its limit
4Application request limit reachedThe app whose token made the request
17User request limit reachedThe user whose token made the request
32(#32) Page request limit reachedThe user or app token used in a Pages API request
613(#613) Calls to this api have exceeded the rate limit.A custom limit set by the API being called
80001(#80001) There have been too many calls to this Page account. Wait a bit and try again.Calls made on that Page with a Page or system user token

哪項限制適用於專頁?

視乎權杖而定。Meta 表示,專頁的速率限制可能採用 Platform 或 Business Use Case 邏輯,取決於所用的權杖類型。使用專頁或系統用戶權杖的 Pages API 呼叫,會遵循專頁的 Business Use Case 限制;使用用戶或應用程式權杖的呼叫,則受該用戶或應用程式的 Platform 限制約束。若兩者都可能適用於某次請求,Meta 會採用 Business Use Case 限制。

上限有多大?

Meta 公布的是計算公式而非固定數字,因此每項配額會隨使用量增加:

  • 應用程式:每名每日活躍用戶每小時 200 次呼叫,按應用程式的所有呼叫合計計算,而非逐名用戶計算。
  • 專頁(使用專頁或系統用戶權杖):每名在 24 小時內與該專頁有互動的用戶,每個滾動 24 小時可獲 4,800 次呼叫。
  • Messenger Send API:每個專頁每秒 300 次呼叫,適用於文字、連結、表情回應及貼圖;音訊或影片則為每秒 10 次。
  • Messenger 呼叫也有其本身的 Business Use Case 類型,以錯誤 80006 回報。

如何察覺限制即將到達?

閱讀用量標頭。若某端點接收應用程式的請求數量足夠多,會包含 X-App-Usage,其中 call_count、total_cputime 及 total_time 為該應用程式 Platform 限制的百分比。依 Business Use Case 邏輯受速率限制的回應,則改為包含 X-Business-Use-Case-Usage,內含每個商業對象的相同百分比、限制類型(例如 pages),以及 estimated_time_to_regain_access。

The two usage headers (Meta's sample X-App-Usage values; illustrative values for the Page)
X-App-Usage: {"call_count": 28, "total_time": 25, "total_cputime": 25}

X-Business-Use-Case-Usage: {
  "{business-object-id}": [
    {
      "type": "pages",
      "call_count": 100,
      "total_cputime": 34,
      "total_time": 41,
      "estimated_time_to_regain_access": 12
    }
  ]
}

要等多久?

直至用量下降,標頭會顯示相關數據。對於 80001 等 Business Use Case 限制,estimated_time_to_regain_access 會給出呼叫不再受限制前所需的分鐘數。對於 Platform 限制,應用程式的 call_count 涵蓋滾動一小時,因此會隨較舊的呼叫逐步過期而下降。Meta 對兩者的指引相同:一旦達到限制,便應停止呼叫,因為繼續呼叫只會增加呼叫次數,並延長呼叫重新成功的時間。

如何保持在限制以下?

減少呼叫次數、降低每次呼叫的負載,並將呼叫分散開來。Meta 的最佳實務包括:平均分散查詢以避免流量高峰;使用篩選器限制回應大小,並避免要求重疊資料的呼叫;當用戶受到限制時,確認問題並非出自應用程式本身。Webhook 亦有幫助:Meta 會在專頁動態活動與訊息發生時即時傳送,因此應用程式無需耗用呼叫去查找。

常見錯誤

  • 立即重試。Meta 警告,持續呼叫會增加呼叫次數,並延長呼叫重新成功的時間。
  • 對所有代碼一視同仁。4 屬於應用程式的限制,17 屬於用戶,80001 屬於專頁,因此放慢錯誤的呼叫方的速度毫無作用。
  • 對使用專頁權杖的呼叫讀取 X-App-Usage。這些呼叫計入 Business Use Case 限制,並會在 X-Business-Use-Case-Usage 中回報。
  • 頻繁輪詢少有互動的專頁。其配額會按與之互動的用戶數量擴展,因此互動較少的專頁可用的呼叫次數也較少。
使用 EasyCoexistence 完成這項設定

當 Meta 限制某次呼叫時,此工具會將 Meta 的代碼與訊息回傳給 Claude、ChatGPT 或你自己的程式,讓你的 AI 能在重試前等待,而 Meta 限制的貼文會於 5 分鐘、30 分鐘及 2 小時後自動重試。每個連接每月 US$ 9 至 US$ 0.75,連接越多價格越低,首 3 天免費試用。

常見問題

應用程式請求次數已達上限是什麼意思?

這是錯誤 4:發出呼叫的權杖所屬應用程式已達速率限制。請停止呼叫,待其用量下降後逐步恢復。

錯誤 32 與錯誤 80001 有何分別?

分別在於權杖。錯誤 32 是用戶或應用程式權杖呼叫 Pages API 時的 Platform 限制;80001 則是使用專頁或系統用戶權杖的呼叫所受的每個專頁限制。

Facebook 速率限制會持續多久?

Meta 沒有固定時間。就 80001 而言,X-Business-Use-Case-Usage 標頭會給出呼叫不再受限制前的分鐘數;應用程式的用量以滾動一小時計算。

錯誤 613 是什麼意思?

這是由所呼叫的 API 設定的自訂速率限制。子代碼 1996 表示 Meta 注意到該應用程式的請求量出現不一致的情況,例如其近期發送的請求數量有所改變。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期