Параметры запросов KeyCRM
В этой статье описаны параметры API-запросов, используемые коннектором KeyCRM для получения данных.
Основные параметры
Параметры запросов к KeyCRM API: limit (ограничение), page (пагинация), filter[status] (фильтр по статусу), filter[created_at] (фильтр по дате создания), include (включение связанных данных).
Пагинация
LightLead автоматически управляет пагинацией при загрузке больших объёмов данных. Типы пагинации:
| Тип | Описание | Параметры |
|---|---|---|
| Страничная (offset) | Постраничная загрузка | page/limit или offset/limit |
| Курсорная (cursor) | Загрузка через курсор | after/next_page_token |
| Временная | Загрузка по диапазону дат | date_from/date_to |
Управление лимитами
Для оптимизации производительности учитывайте:
Размер страницы: оптимальный размер зависит от объёма данных в полях
Частота запросов: соблюдайте rate limits CRM
Параллельные запросы: по возможности запросы выполняются последовательно
Кеширование: часто запрашиваемые данные кешируются
Обработка ошибок
При превышении лимитов или таймаутах LightLead применяет:
Автоматический retry — повтор запроса с экспоненциальной задержкой
Частичная загрузка — сохранение уже полученных данных при прерывании
Уведомление — информирование пользователя о проблемах синхронизации