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 接收其動態活動、提及及訊息,如你需要,可轉發至你的端點,因此無需由任何程式輪詢專頁。
請求中所用權杖所屬的應用程式已達速率限制時的錯誤代碼。
請求中所用權杖所屬的用戶已達速率限制時的錯誤代碼。
用於 Pages API 請求的權杖所屬用戶或應用程式已達速率限制時的錯誤代碼。
自訂速率限制的錯誤代碼;子代碼 1996 表示 Meta 注意到該應用程式的請求量出現不一致的情況。
使用專頁或系統用戶存取權杖進行專頁呼叫時的 Business Use Case 錯誤代碼。
使用專頁或系統用戶存取權杖時,每個滾動 24 小時可進行的 Pages API 呼叫次數。
各項速率限制錯誤代碼是什麼意思?
每個代碼指出已達到的限制,而請求中的權杖決定適用哪一項。Meta 的速率限制指南說明每個代碼的含義,其錯誤參考則列出隨附的錯誤訊息。以下逐一列出,並附上 Meta 所用的訊息:
| Meta's message | What reached its limit | |
|---|---|---|
| 4 | Application request limit reached | The app whose token made the request |
| 17 | User request limit reached | The user whose token made the request |
| 32 | (#32) Page request limit reached | The 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。
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 中回報。
- 頻繁輪詢少有互動的專頁。其配額會按與之互動的用戶數量擴展,因此互動較少的專頁可用的呼叫次數也較少。
當 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 監察
驗證日期