Локальный лимит каждого агента не защищает общую квоту аккаунта. Несколько работников могут одновременно отправить допустимое для себя число запросов и вместе превысить ограничение сервиса. Сначала установите область лимита по документации провайдера: аккаунт, ключ, метод или иной ресурс. Секретный ключ в журнал для этого не копируется.
Проверяйте суммарный поток на заглушке 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 повтор тоже проходит общий допуск. Иначе все агенты дождутся одного срока и снова создадут пик. Предусмотрите распределение повторов и конечную границу ожидания. Если задача потеряла актуальность, её не нужно исполнять только потому, что очередь наконец получила разрешение.
При отказе координатора не переходите незаметно в режим неограниченной отправки. Выберите согласованное ожидание или отказ с понятной причиной. Разделите служебные проверки состояния и новые изменяющие запросы, если у провайдера для них разные области квот. Смена ключей для обхода ограничений не является исправлением.
Приёмка считает физические обращения всех работников
- Запустить несколько работников на одной тестовой области.
- Добавить 429 с предусмотренным Retry-After.
- Проверить общий поток после пробуждения очереди.
- Перезапустить одного работника без обнуления общей истории.
- Испытать отказ координатора и истечение срока задачи.
Ответ 429 не объясняет сам, выполнилась ли предыдущая изменяющая операция при другом сетевом сбое. Идентичность операции и выяснение неизвестного исхода остаются отдельной защитой. Ограничение частоты предотвращает лишний поток, но не превращает повтор создания объекта в безопасное чтение.
Для разбора подготовьте обезличенную область квоты, правило провайдера, временную шкалу общего потока и ответы заглушки. Откат сохраняет ограниченный допуск, а не возвращает бесконтрольные повторы. Результат — несколько агентов делят одну реальную квоту, ждут объяснимо и прекращают просроченную работу вместо бесконечного давления на сервис.