Ограничения частоты запросов IZI API

Ограничения частоты запросов IZI API

IZI API ограничивает количество запросов на токен. Это защищает инфраструктуру и обеспечивает стабильность для всех партнёров.

Квоты

Лимит	Значение
Скользящее окно	10 секунд
Максимум запросов	100 за окно
Единица учёта	Токен (не IP)
Стоимость обычного запроса	1
Стоимость аналитического запроса	5–10 (зависит от сложности)

Лимит скользящий — не сбрасывается раз в 10 секунд, а считается непрерывно по последним 10 секундам.

Заголовки ответа

Каждый ответ API содержит:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 73
X-RateLimit-Reset: 1717072920
X-RateLimit-Cost: 1

• X-RateLimit-Remaining — сколько запросов осталось в текущем окне
• X-RateLimit-Reset — Unix timestamp когда окно сбросится
• X-RateLimit-Cost — стоимость текущего запроса

При превышении лимита:

HTTP/1.1 429 Too Many Requests
Retry-After: 7
X-RateLimit-Remaining: 0

Стратегия обхода 429

async function requestWithBackoff(query, variables, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      return await client.request(query, variables);
    } catch (error) {
      if (error.status === 429) {
        const retryAfter = parseInt(error.headers['retry-after'] || '5', 10);
        // Добавляем jitter чтобы не синхронизировать повторы
        const delay = retryAfter * 1000 + Math.random() * 1000;
        await new Promise(resolve => setTimeout(resolve, delay));
        continue;
      }
      throw error;
    }
  }
  throw new Error('Max retries exceeded');
}

Рекомендации

Для синхронизации данных — используйте webhooks вместо polling’а. Вместо запроса каждые 5 секунд «что изменилось» — подпишитесь на события и получайте пуш при изменении.

Для bulk-операций — группируйте запросы через batching (до 10 в одном POST).

Для аналитики — запускайте тяжёлые запросы в ночное время или кешируйте результаты на стороне.

Связанные страницы

• IZI API: обзор — общая архитектура
• Webhooks — альтернатива polling’у
• Коды ошибок API — полный список кодов ошибок

См. также

• IZI API: обзор для разработчиков
• Авторизация и токены IZI API
• Коды ошибок IZI API
• Основы GraphQL в IZI
• Примеры SDK IZI: JavaScript и Python