Rate Limits

Для обеспечения стабильности системы API NeuroCall Co-Pilot имеет ограничения на количество запросов. Лимиты зависят от вашего тарифного плана.

Текущие лимиты

Тариф	Запросы в минуту	Запросы в час	Запросы в день
Free	10	100	1,000
Starter	60	3,000	10,000
Pro	120	7,000	50,000
Enterprise	300	20,000	200,000

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

Каждый ответ API содержит заголовки с информацией о лимитах:

Заголовок	Описание
`X-RateLimit-Limit`	Максимальное количество запросов
`X-RateLimit-Remaining`	Оставшиеся запросы в текущем окне
`X-RateLimit-Reset`	Время сброса лимита (Unix timestamp)
`X-RateLimit-Retry-After`	Секунд до сброса (только при 429)

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

При превышении лимита API возвращает ошибку 429 Too Many Requests:

HTTP/1.1 429 Too Many Requests Content-Type: application/json X-RateLimit-Retry-After: 45{"error": "rate_limit_exceeded","message": "Превышен лимит запросов. Попробуйте через 45 секунд."}

Обработка 429

Всегда обрабатывайте ошибку 429! Используйте экспоненциальную задержку (backoff) для повторных попыток.

Стратегии оптимизации

1. Используйте вебхуки

Вместо постоянного опроса настройте вебхуки для получения уведомлений о событиях в реальном времени.

2. Пакетная обработка

Группируйте операции в пакеты. Например, обновляйте несколько сделок одним запросом вместо множества отдельных.

3. Кеширование

Кешируйте статические данные (списки пользователей, воронки, статусы) и обновляйте их редко.

4. Пагинация

Всегда используйте пагинацию при получении списков. Не запрашивайте сразу тысячи записей.

Пример backoff

При получении 429 ждите: retry_after * 2^n, где n — номер попытки. Максимум 5 попыток с задержкой до 60 секунд.

Увеличение лимитов

Для Enterprise-клиентов доступно индивидуальное увеличение лимитов. Свяжитесь с поддержкой для обсуждения условий.