Changelog

История изменений партнёрского API. Будем стараться объявлять breaking changes за ≥4 недели и держать v1 живым ещё минимум 6 месяцев после релиза v2.

2026-05-28 — Initial public docs

• Опубликована партнёрская документация на docs.cartelcrm.com.
• API: v1/inbound/leads, v1/inbound/leads/{externalId}/status, callbacks.
• HMAC + Bearer + anti-replay (±300s).
• Idempotency-Key поддерживается.
• Дедупликация по phone / email в окне 30 дней (настраивается per партнёр).
• Field mapping движок: вложенные пути + sentinel-значения (_literal:, _ip, _now, _titlecase:, _lower:, _upper:, _digits:).
• Status mapping (наши коды ↔ ваши коды) — настраивается per партнёр.
• Callback events whitelist (опционально).
• Retry-политика callback'ов: до 5 попыток с экспоненциальной задержкой.

Будущие изменения

Что в roadmap'е

• v1/inbound/leads/batch — пакетная отправка до 50 лидов одним запросом.
• Дополнительные события: lead.deleted, client.churned.
• Веб-хуки для агентских событий (распределение, передача между командами).
• OpenAPI YAML для генерации клиентов на любом языке.

Если что-то из списка нужно вам срочно — напишите менеджеру, обсудим приоритизацию.