Facebook Graph API 速率限制:错误 4、17、32、613 和 80001
Facebook 的 Graph API 会为主页或系统用户访问令牌设定每 24 小时滚动计算的 Pages API 调用上限:每位互动用户 4,800 次。超出限制时,接口会返回以下错误之一:4,Application request limit reached;17,User request limit reached;32,Page request limit reached;613,Calls to this api have exceeded the rate limit;或 80001,There have been too many calls to this Page account。请先停止调用,然后逐步恢复。
easyCoexistence 使用每个已连接主页自身的访问令牌为其调用接口,并通过 Meta 的 Webhook 接收其动态活动、提及和消息,如有需要再转发至您的端点,因此无需任何程序轮询主页。
请求中所用访问令牌对应的应用已达到速率限制时返回的错误代码。
请求中所用访问令牌对应的用户已达到其速率限制时返回的错误代码。
请求中所用访问令牌对应的用户或应用在调用 Pages API 时已达到速率限制时返回的错误代码。
自定义速率限制的错误代码;子代码 1996 表示 Meta 发现该应用的请求量表现不一致。
使用主页或系统用户访问令牌进行主页调用时,所对应的 Business Use Case 错误代码。
使用主页或系统用户访问令牌时,Pages API 在滚动 24 小时内允许的调用次数。
每个代码表示什么速率限制?
每个代码说明已达到的是哪一种限制,请求中的访问令牌决定适用哪一种。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 对两者的指导相同:一旦达到限制就停止调用,因为继续调用会增加 call_count,并延长调用恢复成功所需的时间。
如何保持在限制以内?
减少调用次数、降低单次调用的负载,并让调用分散进行。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 天免费。
常见问题
Application request limit reached 是什么意思?
这是错误 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 监控
验证时间