Режимы интеграции: server-side (API) и client-side (ads.js)

Изменено Пн, 17 Авг на 11:06 PM

Вся тяжёлая логика — вызов LLM, определение интента, матчинг каталога, click-токены, лимиты — на стороне Indoleads. Ваше приложение только передаёт нам диалог и рисует карточку.


один ход диалога
Пользователь → [ваше приложение] → HTTPS → [Indoleads AI Ads API] → LLM
                     ↑                                  │
                     └────────── reply + ad (карточка) ─┘

клик по карточке (домен Indoleads, не ваш)
Пользователь → GET /c/{token} → 302 → трекинг-ссылка сети → рекламодатель

	Режим A — server-side (рекомендуем)	Режим B — client-side
Как	Ваш бэкенд вызывает `POST /api/chat`, получает JSON, рисует карточку в своём UI	На страницу подключается наш `ads.js`; вызовы идут из браузера через `IndoleadsAds.chat()` / `renderAd()`
Ключ	Остаётся на вашем сервере, в секретах	Публичный ключ на домен; домены в whitelist
Контроль	Полный — вы решаете, когда и как показывать	Меньше — зато быстрее всего внедрить
CSP	`connect-src` домен API, `img-src` CDN мерчантов	+ `script-src` домен ads.js
Кому подходит	Продуктам со своим бэкендом/LLM-пайплайном	Статичным сайтам, виджетам, быстрым пилотам

В обоих режимах ответ один и тот же — reply (показывать всегда) + ad (объект или null) + intent — см. Контракт API. В обоих режимах клик должен идти только через нашу ссылку /c/{token}.

Требования к серверу для режима A: любой язык с исходящим HTTP+JSON, UTF-8, исходящий HTTPS 443, TLS 1.2+ — см. Требования.