Ошибка 429 Ozon API: проверьте Retry-After перед повтором

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

Что доступно в ответе Ozon

Согласно официальному сообщению от 25 сентября 2026 года, Seller API передаёт Ratelimit-Remaining, показывающий оставшееся число запросов до лимита. Заголовок Retry-After возвращается при ошибке 429 и указывает, через сколько секунд можно отправить повторный запрос.

Это сведения для диагностики и настройки обмена. Ниже приведён редакционный порядок проверки; он не устанавливает универсальный лимит для всех методов Ozon.

Сохраните один подтверждённый случай

До очередного ручного перезапуска попросите интегратора сохранить время запроса с часовым поясом, метод, HTTP-статус и указанные заголовки ответа. Нужны также время следующей попытки и результат. Удалите из передаваемых журналов ключи, токены и персональные данные.

Если интерфейс показывает только «ошибка обмена», по этой надписи нельзя установить 429. Сначала подтвердите реальный статус. Для другой ошибки потребуется отдельная диагностика.

Сопоставьте ответ и повтор

Проверьте по журналу, выдерживает ли обработчик указанное сервером ожидание перед повторной попыткой. Зафиксируйте все процессы, которые отправляли запросы к этому методу в тот же период: основная выгрузка, ручной запуск, фоновая синхронизация. Иначе проверка одного процесса может пропустить другой источник нагрузки.

Не превращайте остаток из Ratelimit-Remaining в постоянную настройку допустимой частоты: это наблюдение конкретного ответа. Если нужного заголовка нет, передайте полный обезличенный контекст разработчику, а не придумывайте значение ожидания по соседнему запросу.

Проверьте, что очередь восстановилась

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

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