Ограничения API Ozon для rFBS: лимиты и квоты
СПРАВКАAPI Ozon имеет строгие квоты: 10 запросов в секунду, 1000 запросов в час на один API-ключ, максимальный размер ответа 10 МБ, пагинация до 1000 записей. Превышение приводит к ошибке 429 и временной блокировке.
Лимит по времени
10 запросов в секунду, 1000 в час. Для важных операций (смена тарифа) рекомендуется не более 1 запроса в 2 секунды.
Лимит по объёму
Максимальный размер тела запроса — 1 МБ, ответа — 10 МБ. При загрузке остатков через Excel файл не более 1000 строк.
Пагинация
Методы списков (order/list, product/list) возвращают не более 1000 записей на страницу. Используйте offset для загрузки всех данных.
Сравнение
| Критерий | По теме страницы | Безлимитный API (недоступен) |
|---|
| Параметр | API Ozon (rFBS) | API Wildberries (FBS) |
| Лимит запросов в секунду | 10 | 5 |
| Лимит запросов в час | 1000 | 500 |
| Макс. размер ответа | 10 МБ | 5 МБ |
Как это работает
1
Шаг 1: Изучите документацию
На странице developer.ozon.com/api/seller ознакомьтесь с лимитами для каждого эндпоинта.
2
Шаг 2: Добавьте проверку лимитов
В коде после каждого запроса считывайте X-RateLimit-Remaining и останавливайтесь при остатке
3
Шаг 3: Реализуйте retry с задержкой
При ошибке 429 ждите Retry-After секунд. Повторите запрос.
4
Шаг 4: Настройте мониторинг
Логируйте количество запросов и ошибки. Используйте алерты при превышении 80% дневной квоты.
Подробно
Как читать заголовки лимитов в ответе API
Каждый ответ содержит заголовки: X-RateLimit-Limit (макс. запросов в секунду), X-RateLimit-Remaining (осталось), X-RateLimit-Reset (время сброса в секундах). Рекомендуется отлавливать эти заголовки в коде и снижать нагрузку, если remaining
Что делать при ошибке 429 Too Many Requests
При получении ошибки 429 необходимо остановить все запросы на время, указанное в заголовке Retry-After (обычно 1 минута). Повторная попытка немедленно приведёт к продлению блокировки. Используйте экспоненциальную задержку с начальным значением 5 секунд. Если ошибка повторяется более 3 раз подряд, проверьте код на наличие бесконечного цикла.
Словарь терминов
Квота—Максимальное количество запросов за определённый период, установленное для API-ключа.
Ошибка 429—HTTP-статус, означающий превышение лимита запросов.
Пагинация—Механизм разбивки ответа на страницы для обхода ограничения на количество записей.
Отзывы
Чёткие лимиты, легко контролировать через заголовки. После внедрения мониторинга перестали падать с 429.
Сначала часто получала 429, пока не разобралась с лимитами. Теперь всё стабильно. Статья помогла.
Частые вопросы
Можно ли увеличить лимиты API?
Нет, лимиты фиксированы для всех продавцов. Можно получить приоритетный доступ при партнёрстве с Ozon.
Как сбросить лимит после блокировки?
Дождитесь указанного в ответе времени (Retry-After). Обычно 1 минута.
Какие запросы расходуют больше квоты?
Запросы на создание отчётов (report/create) расходуют 1 запрос, но генерация может занимать до 10 минут. Не дублируйте запросы.
C
Cdek-Logistika
Редакция портала · проверка фактов
Материал подготовлен в формате справочного разбора для информационного портала.
Ознакомьтесь с лимитами API Ozon для rFBS — избегайте блокировок и ошибок. Настройте мониторинг и retry уже сегодня.
Cdek-Logistika·ОГРН: 317527500128941·ИНН: 525110282730·Россия, Тюменская область, Тюмень, Дзержинского, 15, 1 офис·Email: cdeklogistika@cdek.ru
19.07.2026