Обмеження запитів

API використовує ковзний віконний обмежувач запитів для кожного API-ключа. Ліміт за замовчуванням — 60 запитів на хвилину.

Заголовки відповіді

Кожна відповідь API містить заголовки з інформацією про ліміти:

Заголовок	Опис
X-RateLimit-Limit	Максимум запитів на хвилину
X-RateLimit-Remaining	Залишок запитів у поточному вікні
X-RateLimit-Reset	Unix timestamp скидання вікна

Приклад:

HTTP/1.1 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1700000060

Перевищення ліміту

При перевищенні ліміту ви отримаєте HTTP 429:

{
  "success": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 45 seconds."
  }
}

Заголовок Retry-After вказує, скільки секунд чекати:

HTTP/1.1 429 Too Many Requests
Retry-After: 45

Рекомендації

• Кешуйте відповіді, де можливо, замість повторних однакових запитів
• Використовуйте пагінацію для зменшення кількості запитів (завантажуйте 100 елементів замість 10)
• Реалізуйте експоненційний відкат при повторних спробах після відповіді 429
• Використовуйте вебхуки замість опитування для даних в реальному часі (нові ліди, повідомлення)
• Групуйте операції, де можливо, для зменшення загальної кількості запитів