WooCommerce REST API: как исправить ошибку 429 Too Many Requests при массовых запросах

Диагностика ошибки 429 Too Many Requests в WooCommerce REST API

Ошибка 429 появляется, когда клиент превышает лимит запросов к серверу за отведённый промежуток времени. В WooCommerce REST API это часто происходит при массовом обновлении заказов, синхронизации товаров или интеграции с внешними сервисами.

Чтобы проверить, что ошибка 429 связана именно с ограничением частоты запросов (rate limiting), обратите внимание на заголовки ответа:

HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json

Заголовок Retry-After указывает, сколько секунд нужно подождать перед следующей попыткой. Если его нет, нужно проверить настройки сервера или плагинов безопасности.

Причины возникновения ошибки 429 в WooCommerce REST API

• Ограничения на уровне сервера (например, mod_evasive, fail2ban, firewall).
• Плагины безопасности (Wordfence, iThemes Security) с настройками rate limit.
• Хостинг с собственными лимитами API-запросов.
• WooCommerce REST API лимиты, если задействованы плагины кеширования или прокси.

Пошаговое решение проблемы

1. Проверяем серверные ограничения

Если у вас есть доступ к серверу, проверьте конфигурацию Apache/Nginx и установленные модули, которые могут блокировать частые запросы. Например, в Apache в файле httpd.conf или в .htaccess могут быть правила mod_evasive:

DOSHashTableSize 3097
DOSPageCount  2
DOSSiteCount  50
DOSPageInterval 1
DOSSiteInterval 1
DOSBlockingPeriod 10

Попробуйте временно отключить mod_evasive или увеличить параметры.

2. Настройка плагинов безопасности

В Wordfence или аналогичных плагинах проверьте настройки Rate Limiting. Например, в Wordfence можно увеличить лимиты для вашего IP или отключить блокировку REST API:

• Перейдите в Wordfence → Firewall → Rate Limiting.
• Установите параметры так, чтобы частота запросов из вашего приложения не блокировалась.

3. Реализация экспоненциального бэкоффа в клиенте

Если вы делаете массовые запросы к API, рекомендуем реализовать в клиенте механизм экспоненциального ожидания при получении 429:

function requestWithBackoff(url, options, retries = 5) {
  return fetch(url, options).then(response => {
    if (response.status === 429 && retries > 0) {
      const retryAfter = response.headers.get('Retry-After') || 1;
      return new Promise(resolve => {
        setTimeout(() => {
          resolve(requestWithBackoff(url, options, retries - 1));
        }, retryAfter * 1000);
      });
    }
    return response;
  });
}

Такой подход уменьшит нагрузку и позволит корректно обрабатывать лимиты.

4. Использование batch-обновлений через WP REST API

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

POST /wp-json/wc/v3/products/batch
{
  "update": [
    {"id": 123, "regular_price": "15.00"},
    {"id": 124, "regular_price": "20.00"}
  ]
}

Используйте этот метод для уменьшения количества запросов и снижения вероятности 429.

Проверка результата после внедрения

После внесения изменений повторите массовые запросы и убедитесь, что:

• Отсутствуют ошибки 429 в ответах.
• Заголовок Retry-After не возвращается.
• Логи сервера не фиксируют блокировки IP.

Для мониторинга можно использовать консоль браузера, Postman или скрипты с логированием статусов ответов.

Частые ошибки и как их исправить

• Игнорирование Retry-After: клиент продолжает слать запросы без пауз — добавьте обработку Retry-After.
• Ошибочный IP-адрес: если за NAT несколько пользователей, ограничение срабатывает на всех — настройте прокси или используйте авторизацию.
• Плагины кеширования: иногда кеширует ответы с ошибками — отключите кеш для REST API путей.
• Неиспользование batch-запросов: разбейте операции на пакеты.

Практические советы по безопасности и производительности

• Не используйте простые логины и открытые ключи для API — применяйте OAuth или JWT.
• Ограничьте доступ к WooCommerce REST API по IP или по ролям пользователей.
• Добавьте кеширование GET-запросов через transient API или внешние кеш-системы.
• Используйте плагины, например Clearfy Pro, для оптимизации безопасности и удаления лишних запросов.

Сравнение способов решения ошибки 429