ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Лимиты запросов Graph API Facebook: ошибки 4, 17, 32, 613 и 80001

Graph API Facebook даёт токену Страницы или системного пользователя 4 800 вызовов API Страниц на каждого вовлечённого пользователя за скользящие 24 часа. При превышении лимита API возвращает код 4: «Достигнут лимит запросов приложения»; код 17: «Достигнут лимит запросов пользователя»; код 32: «Достигнут лимит запросов Страницы»; код 613: «Вызовы этого API превысили ограничение частоты запросов»; или код 80001: «К этому аккаунту Страницы было слишком много вызовов». Прекратите вызовы, затем возобновите их постепенно.

easyCoexistence вызывает каждую подключённую Страницу со своим токеном и принимает активность ленты, упоминания и сообщения через вебхуки Meta, при желании пересылая их на ваш эндпоинт, поэтому никому не нужно опрашивать Страницу.

4

Код, который возвращается, когда у приложения, токен которого указан в запросе, достигнуто ограничение частоты запросов.

17

Код, который возвращается, когда у пользователя, токен которого указан в запросе, достигнуто ограничение частоты запросов.

32

Код, который возвращается, когда у пользователя или приложения, токен которых используется в запросе к API Страниц, достигнуто ограничение частоты запросов.

613

Код пользовательского ограничения частоты запросов; с подкодом 1996 Meta обнаружила нестабильное поведение объёма запросов приложения.

80001

Код Business Use Case для вызовов Страницы, выполненных с токеном доступа Страницы или системного пользователя.

4,800 × engaged users

Количество вызовов API Страниц, разрешённых за скользящие 24 часа с токеном Страницы или системного пользователя.

Что означает каждый код ограничения частоты запросов?

Каждый код указывает на достигнутое ограничение, а токен в запросе определяет, какое из них применяется. В руководстве 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 в зависимости от типа токена. Вызовы 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.

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
    }
  ]
}

Сколько ждать?

Пока использование не снизится, что показывают заголовки. Для ограничения 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.
  • Часто опрашивать тихую Страницу. Её лимит растёт вместе с пользователями, которые взаимодействовали с ней, поэтому у Страницы с малой активностью меньше вызовов для расходования.
Настройка с EasyCoexistence

Когда 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 обнаружила нестабильное поведение объёма запросов приложения, например после недавнего изменения количества отправляемых запросов.

Читайте дальше

Ошибка Facebook 368: временная блокировка за нарушение правилОшибка Facebook 368: действие признано злоупотреблением или не разрешено. Что значит временная блокировка и как проверить Page.Ошибка Facebook 190: токен доступа недействителен или истёкОшибка Facebook 190, Error validating access token и Invalid OAuth 2.0 Access Token: почему токен Страницы перестаёт работать, что значат подкоды и как исправить.Ошибка Facebook 100: неверный параметрОшибка Facebook 100 (Invalid parameter): Meta отклонила поле, ID или настройку, например время публикации вне допустимого диапазона.Ошибка 200 в Facebook: нет нужного разрешенияОшибка 200 в Facebook означает, что токену не хватает разрешения, нужного запросу, например pages_manage_posts для публикации. Как найти и выдать.Ошибка Facebook 10: доступ запрещён или сообщение вне разрешённого окнаОшибка Facebook 10: «Application does not have permission for this action» или в Messenger «This message is sent outside of allowed window».Вебхук ленты Facebook Страницы: события комментариев, публикаций и реакцийЧто передаёт вебхук ленты Facebook Страницы при комментариях, публикациях и реакциях: поля item и verb, структура тела запроса Meta и подписка Страницы.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на