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

Проверяйте суммарный поток на заглушке API с искусственной квотой. Посчитайте исходные вызовы и повторы всех работников за выбранный интервал. Не создавайте нагрузочный эксперимент на рабочем внешнем аккаунте без предусмотренного разрешения: он способен остановить реальные задачи других потребителей того же лимита.

Лимит одного процесса не равен квоте сервиса

УровеньЧто ограничиваетЧего не видит
АгентСобственные попыткиДругих работников
Общий координаторПоток одной области квотыДругие системы вне координации
ПровайдерСвою фактическую политикуВашу важность конкретной задачи
ОчередьДопуск и ожидание работыИсход уже отправленной операции

RFC 6585 определяет ответ 429 Too Many Requests и допускает Retry-After. RFC 9110 описывает Retry-After как дату HTTP либо число секунд ожидания. Проверено 14 октября 2026 года. Ни один из этих документов не задаёт конкретную квоту вашего провайдера — её параметры и область берутся из его актуального договора.

Разрешение на вызов выдаётся перед отправкой

Условный договор общей квоты:
quota_scope: <аккаунт и метод без секрета>
operation_id: <бизнес-операция>
permit: granted / wait / denied
next_eligible_at: <расчётная граница>
attempt_budget: <ограничение процесса>
deadline: <крайний срок задачи>

Координатор должен выдавать разрешения согласованно для всех работников этой области. Алгоритм выбирается под реальное правило сервиса: скользящее окно, число одновременных запросов и расход единиц не взаимозаменяемы. Запрос с большим весом нельзя всегда считать одним обычным вызовом. Не подставляйте придуманный универсальный лимит.

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

При отказе координатора не переходите незаметно в режим неограниченной отправки. Выберите согласованное ожидание или отказ с понятной причиной. Разделите служебные проверки состояния и новые изменяющие запросы, если у провайдера для них разные области квот. Смена ключей для обхода ограничений не является исправлением.

Приёмка считает физические обращения всех работников

  1. Запустить несколько работников на одной тестовой области.
  2. Добавить 429 с предусмотренным Retry-After.
  3. Проверить общий поток после пробуждения очереди.
  4. Перезапустить одного работника без обнуления общей истории.
  5. Испытать отказ координатора и истечение срока задачи.

Ответ 429 не объясняет сам, выполнилась ли предыдущая изменяющая операция при другом сетевом сбое. Идентичность операции и выяснение неизвестного исхода остаются отдельной защитой. Ограничение частоты предотвращает лишний поток, но не превращает повтор создания объекта в безопасное чтение.

Для разбора подготовьте обезличенную область квоты, правило провайдера, временную шкалу общего потока и ответы заглушки. Откат сохраняет ограниченный допуск, а не возвращает бесконтрольные повторы. Результат — несколько агентов делят одну реальную квоту, ждут объяснимо и прекращают просроченную работу вместо бесконечного давления на сервис.

Проверенные источники