Лимиты API Meta: как дашборды и скрипты подставляют кабинеты

Лимиты API Meta: как дашборды и скрипты подставляют кабинеты

Написано

в

Вы подключили к кабинету дашборд, бота уведомлений, скрипт правил и ещё пару сервисов. Через неделю — ошибки «слишком много запросов», данные не обновляются, а в худшем случае появляются ограничения. Причина часто одна: все эти инструменты по отдельности ходят в API Meta и вместе превышают лимиты.

Как устроены лимиты API Meta

Marketing API ограничивает количество и «тяжесть» запросов. Лимиты считаются на разных уровнях: на приложение, на пользователя (токен) и на рекламный аккаунт. Тяжёлые запросы — большие отчёты с разбивками за длинный период — расходуют лимит быстрее простых.

При превышении Meta возвращает ошибки ограничения частоты (например, коды 17, 4, 613, 80004) и на время замедляет или блокирует запросы. В ответах API есть заголовки с текущим использованием лимита — хороший инструмент их читает и притормаживает заранее.

Почему это бьёт по байерам

  • Несколько инструментов на одном кабинете. Каждый уверен, что он один, и опрашивает API как может.
  • Частые тяжёлые отчёты. Разбивки за 30 дней каждые 5 минут — быстрый способ съесть лимит.
  • Один токен на много кабинетов. Если токен упёрся в лимит, страдают все кабинеты, к которым он подключён.
  • Повторы без паузы. Скрипт получил ошибку лимита и сразу повторяет запрос — ещё глубже в лимит.

Слишком частые запросы к API — один из способов получить ограничения от Meta. Даже если до блокировки не доходит, вы теряете свежесть данных именно тогда, когда она нужна: правила не срабатывают, отчёты пустые.

Как работать с API бережно

1. Храните историю у себя

Вчерашние и более старые данные не меняются часто. Их нужно забрать один раз и хранить в базе, а не запрашивать заново для каждого отчёта.

2. Разделяйте частоту запросов по задачам

  • Сегодняшняя статистика для правил — часто, но лёгкими запросами.
  • Разбивки по возрасту, плейсментам и т. п. — раз в сутки, и только по кабинетам с расходом.
  • Справочные данные (названия, статусы) — с кэшем.

3. Следите за использованием лимита

Читайте заголовки использования из ответов API и снижайте частоту, когда приближаетесь к порогу, а не после ошибки.

4. Правильно повторяйте

При ошибке лимита — экспоненциальная пауза, а не мгновенный повтор. Если кабинет «занят», отложите проверку на несколько минут.

5. Не держите мёртвые токены

Токен, который стабильно возвращает ошибки авторизации, лучше переподключить или удалить: инструменты продолжают пытаться им пользоваться.

Чек-лист для вашего стека

  1. Перечислите все сервисы и скрипты, у которых есть доступ к кабинетам.
  2. Уберите дублирующие: два сервиса, которые делают одно и то же, удваивают нагрузку.
  3. Узнайте, как часто каждый ходит в API и хранит ли историю.
  4. Распределите кабинеты по токенам, чтобы один перегруженный токен не останавливал всё.

Как это сделано в Krylo

В Krylo нагрузка на API Meta — одна из ключевых тем:

  • история и отчёты хранятся в базе, AI-аналитик и Krylo MCP берут их оттуда;
  • предохранитель на уровне кабинета и токена притормаживает запросы при приближении к лимитам;
  • если кабинет занят заливом, проверка автоправил откладывается и повторяется через несколько минут;
  • тяжёлые разбивки собираются реже и только там, где есть расход.

Итог

Лимиты API Meta — не абстрактная техническая деталь: от них зависит, сработает ли стоп-правило вовремя. Храните историю у себя, разводите частоту по задачам, следите за использованием лимита и не подключайте к кабинету лишние инструменты.