Лимиты запросов Graph API Facebook: ошибки 4, 17, 32, 613 и 80001
Graph API Facebook даёт токену Страницы или системного пользователя 4 800 вызовов API Страниц на каждого вовлечённого пользователя за скользящие 24 часа. При превышении лимита API возвращает код 4: «Достигнут лимит запросов приложения»; код 17: «Достигнут лимит запросов пользователя»; код 32: «Достигнут лимит запросов Страницы»; код 613: «Вызовы этого API превысили ограничение частоты запросов»; или код 80001: «К этому аккаунту Страницы было слишком много вызовов». Прекратите вызовы, затем возобновите их постепенно.
easyCoexistence вызывает каждую подключённую Страницу со своим токеном и принимает активность ленты, упоминания и сообщения через вебхуки Meta, при желании пересылая их на ваш эндпоинт, поэтому никому не нужно опрашивать Страницу.
Код, который возвращается, когда у приложения, токен которого указан в запросе, достигнуто ограничение частоты запросов.
Код, который возвращается, когда у пользователя, токен которого указан в запросе, достигнуто ограничение частоты запросов.
Код, который возвращается, когда у пользователя или приложения, токен которых используется в запросе к API Страниц, достигнуто ограничение частоты запросов.
Код пользовательского ограничения частоты запросов; с подкодом 1996 Meta обнаружила нестабильное поведение объёма запросов приложения.
Код Business Use Case для вызовов Страницы, выполненных с токеном доступа Страницы или системного пользователя.
Количество вызовов 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 в зависимости от типа токена. Вызовы API Страниц с токеном Страницы или системного пользователя подчиняются ограничению Business Use Case для Страниц, а вызовы с токеном пользователя или приложения подчиняются лимитам Platform для пользователя или приложения. Если под запрос подходят оба варианта, Meta применяет ограничение Business Use Case.
Насколько велики ограничения?
Meta публикует формулы, а не фиксированные числа, поэтому каждый лимит растёт вместе с использованием:
- Приложения: 200 вызовов в час на каждого ежедневно активного пользователя; считаются все вызовы приложения, а не вызовы отдельного пользователя.
- Страницы, с токеном Страницы или системного пользователя: 4 800 вызовов за скользящие 24 часа на каждого пользователя, который взаимодействовал со Страницей за эти сутки.
- 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
}
]
}Сколько ждать?
Пока использование не снизится, что показывают заголовки. Для ограничения Business Use Case, например 80001, estimated_time_to_regain_access показывает минуты до того, как вызовы перестанут ограничиваться. Для ограничений Platform call_count охватывает скользящий час, поэтому значение падает по мере того, как старые вызовы выходят из учёта. Рекомендация Meta одинакова для обоих случаев: прекратите вызовы, как только достигнуто ограничение, поскольку продолжение увеличивает счётчик вызовов и время до того, как вызовы снова начнут проходить.
Как оставаться в пределах ограничений?
Делайте вызовы реже и легче и распределяйте их равномерно. Лучшие практики Meta: равномерно распределять запросы, чтобы избежать всплесков трафика, использовать фильтры, чтобы ограничить размер ответов и не делать вызовы, запрашивающие пересекающиеся данные, а при ограничении пользователей убедиться, что причина не в приложении. Вебхуки тоже помогают: Meta доставляет активность ленты Страницы и сообщения по мере их появления, поэтому приложению не нужно тратить вызовы на их поиск.
Распространённые ошибки
- Повторять сразу. Meta предупреждает, что продолжение вызовов увеличивает счётчик вызовов и время до того, как вызовы снова начнут проходить.
- Считать все коды одинаковыми. Код 4 относится к приложению, 17 к пользователю, а 80001 к Странице, поэтому замедление не того вызывающего ничего не меняет.
- Читать X-App-Usage для вызовов с токеном Страницы. Они учитываются в лимите Business Use Case и отображаются в X-Business-Use-Case-Usage.
- Часто опрашивать тихую Страницу. Её лимит растёт вместе с пользователями, которые взаимодействовали с ней, поэтому у Страницы с малой активностью меньше вызовов для расходования.
Когда Meta ограничивает вызов, инструмент возвращает код и сообщение Meta в Claude, ChatGPT или ваш собственный код, чтобы ваш ИИ мог подождать перед повторной попыткой, а пост, который Meta ограничивает, автоматически повторяется через 5 минут, 30 минут и 2 часа. От US$ 9 до US$ 0,75 за подключение в месяц, снижаясь по мере добавления подключений, с бесплатным пробным периодом на первые 3 дня.
Часто задаваемые вопросы
Что означает сообщение «Достигнут лимит запросов приложения»?
Это ошибка 4: приложение, токен которого выполнил вызов, достигло ограничения частоты запросов. Прекратите вызовы, затем возобновляйте их постепенно по мере снижения использования.
В чём разница между ошибкой 32 и ошибкой 80001?
В токене. Ошибка 32 является ограничением Platform для токена пользователя или приложения, которое вызывает API Страниц. Ошибка 80001 является ограничением для каждой Страницы при вызовах с токеном Страницы или системного пользователя.
Как долго действует ограничение частоты запросов Facebook?
Meta не задаёт фиксированного срока. Для 80001 заголовок X-Business-Use-Case-Usage показывает минуты до того, как вызовы перестанут ограничиваться; использование приложения измеряется за скользящий час.
Что означает ошибка 613?
Пользовательское ограничение частоты запросов, которое задаёт вызываемый API. С подкодом 1996 Meta обнаружила нестабильное поведение объёма запросов приложения, например после недавнего изменения количества отправляемых запросов.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на