Контракт API: POST /api/chat

Авторизация: заголовок Authorization: Bearer <партнёрский ключ>. У sandbox и production разные ключи и базовые URL (выдаются при онбординге).

Один вызов на ход диалога, синхронно с ответом ассистента. Тело ≤ 256 КБ — передавайте последние ~8–12 ходов, а не всю историю.

Запрос

{
  "messages": [ {"role":"user","content":"нужен рюкзак для ноутбука"} ],
  "geo": "MY",
  "session_id": "abc123",
  "lang": "ru"
}

• messages[] — обязательно; история диалога, роли user / assistant.
• geo — обязательно; страна пользователя, ISO-3166 alpha-2 (MY, ID, BR…). От неё зависят инвентарь и ставки.
• session_id — опционально; стабильный на сессию пользователя, для честных лимитов и антифрода.
• lang — опционально; подсказка о языке интерфейса.
• Опциональный заголовок X-Forwarded-For с IP конечного пользователя для лимитов на пользователя. PII не требуется.

Ответ 200

{
  "reply": "…текст ассистента, показывать всегда…",
  "ad": {
    "type": "product",
    "title": "…", "desc": "…", "price": "MYR 129",
    "image": "https://cdn…/p.jpg",
    "sponsored": true,
    "click_url": "https://api.indoleads.ai/c/<token>"
  },
  "intent": { "show_ad": true, "confidence": 0.72, "category": "…" }
}

• reply — рендерить всегда.
• ad — объект или null (нет коммерческого интента). type: product | offer | coupon (есть code) | banner. Рисуйте title, desc, price, image; ссылка на click_url с rel="sponsored noopener" target="_blank" и видимой меткой Sponsored. Никогда не переписывайте и не оборачивайте click_url.
• intent — для вашей аналитики.

Коды ответа

Задержка: определяется LLM — 0,8–3 с, редко 5–8 с. Таймаут клиента ≥ 10 с. При ошибке/таймауте/ad:null показывайте ответ без карточки — реклама никогда не должна ломать чат.