Поиск через API, без виджета

Виджет не обязателен: тот же разговор доступен по API, если вы рисуете свой интерфейс — в мобильном приложении, в личном кабинете или в чат-боте.

Одна ручка на весь разговор

POST https://aisse.ru/v1/message
X-API-Key: ваш секретный ключ
Content-Type: application/json

{"query": "нужно вывезти мусор из подвала", "session_id": null}

В ответе приходит session_id — передавайте его в следующих репликах, и разговор продолжится с памятью о предыдущих. Что это за реплика — новая задача, уточнение, выбор варианта или согласие, — определяем мы сами.

Типы ответа

• question — помощник задал уточняющий вопрос, карточек нет;
• items — подбор: список позиций с объяснением, почему они подходят;
• reply — ответ репликой без поиска;
• no_match — подходящего нет, стоит показать вашу форму заявки.

Документ вместо текста

POST https://aisse.ru/v1/upload

Multipart с полем file, дополнительно session_id и comment. Принимаем PDF, DOCX, XLSX, TXT и CSV до 10 МБ; файл нигде не сохраняется, из него берётся только текст.

Ограничения

Запросы считаются по тарифу так же, как из виджета. При исчерпанном лимите ручка отвечает кодом 402 — обработайте его и покажите человеку запасной путь.

Полное описание всех ручек с примерами — в документации API.

Если интерфейс писать не нужно, а каталог должен отвечать в чужом ИИ-помощнике, — это соседний путь: Каталог в ChatGPT и Claude.