Перейти к содержимому
Филин Филин · Для разработчиков Бета

Батчи и идемпотентность

Бета. Контракт может меняться. Доступ к боевому API открывается после подключения (оплаты).

Идемпотентность по external_id

Повторная отправка той же сущности - upsert (обновление, не дубль). Можно безопасно перезаливать что угодно: Филин сопоставляет записи по вашим external_id и обновляет их, а не плодит копии.

Размер батча

  • Каждый POST принимает массив.
  • Рекомендованный размер - до 500 объектов на запрос (для коммуникаций с крупными транскриптами - меньше).
  • Батч больше лимита → 413, разбейте на части.

Первичная загрузка истории

  • Заливайте 30-90 дней истории пачками, соблюдая порядок: employees и pipelines → deals → communications, notes, attachments.
  • Для энтерпрайза 20+ сотрудников это десятки тысяч коммуникаций - шлите последовательными батчами, не одним запросом.
  • Аудио можно догружать вторым проходом: Филин транскрибирует по мере поступления (см. Аудио и транскрипция).

Инкрементальная досылка

После первичной заливки шлите только новое или изменившееся - по мере появления или пачкой раз в сутки до ночного цикла (22:00 МСК), чтобы попало в ближайший разбор.

Что переоценивается - см. дельта-модель в Как работает Филин: новая коммуникация, новая заметка живого сотрудника или смена стадии сделки.

Дальше