Встройте AI-поиск LiKE в ваши приложения, сайт или внутренние системы. Три способа интеграции: REST API, JS-виджет, iframe.
#REST API
#Шаг 1 — Создайте API-ключ
- Интеграции → Public API → «Создать ключ»
- Введите название (например, «Мобильное приложение»)
- Скопируйте ключ — он показывается только один раз
#Шаг 2 — Используйте API
Все запросы авторизуются через заголовок:
X-API-Key: ваш-ключ#Основные endpoints
| Endpoint | Метод | Описание |
|---|---|---|
/api/public/search |
POST | AI-поиск по базе знаний |
/api/public/articles |
GET | Список статей |
/api/public/articles/{id} |
GET | Содержимое статьи |
#Пример: AI-поиск
curl -X POST https://amedia.lynkora.pro/api/public/search \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Как оформить отпуск?"}'Ответ:
{
"answer": "Для оформления отпуска...",
"sources": [
{"title": "Политика отпусков", "url": "..."}
]
}#Rate limits
Запросы к API ограничены по каждому ключу. Конкретный лимит зависит от вашего тарифа; при превышении возвращается HTTP 429 с заголовком Retry-After. Точные значения для вашего плана — в разделе тарифа.
#Безопасность
- Храните ключи в переменных окружения, не в коде
- Создавайте отдельный ключ для каждого приложения
- Удаляйте неиспользуемые ключи
- Ограничивайте домены в настройках ключа
#JS-виджет
Плавающая кнопка AI-поиска для встраивания на любой сайт.
#Шаг 1 — Получите код
- Интеграции → JS Widget
- Настройте параметры (см. таблицу ниже)
- Скопируйте код
#Шаг 2 — Вставьте на сайт
Вставьте скопированный <script> перед закрывающим тегом </body>:
#Параметры виджета
| Параметр | Значение | Описание |
|---|---|---|
data-key |
wk_live_... |
Обязательный. Ключ виджета (создаётся в Интеграции → JS Widget). Без него виджет не запустится |
data-position |
bottom-right / bottom-left / none |
Позиция плавающей кнопки (по умолчанию bottom-right) |
data-theme |
light / dark / auto |
Тема оформления (по умолчанию light) |
data-lang |
ru / en / de / es / fr / ar |
Язык интерфейса (по умолчанию — автоопределение по браузеру) |
data-hotkey |
k |
Клавиша открытия в сочетании с Cmd/Ctrl (по умолчанию k → Cmd/Ctrl + K) |
data-session-token |
JWT | Опционально. Session-токен для режима per-user identity (см. «Сравнение режимов аутентификации» ниже) |
#Результат
На вашем сайте появится фиолетовая кнопка в углу. Клик → модальное окно с поисковой строкой → AI-ответ из вашей базы знаний.
#iframe
Полноценный интерфейс поиска, встроенный на вашу страницу:
#Код для вставки
#Прямая ссылка
Если iframe не подходит — дайте пользователям прямую ссылку: https://amedia.lynkora.pro
#Демо-режим
Для тестирования без API-ключа доступен демо-endpoint с ограничениями:
| Параметр | Значение |
|---|---|
| Запросов в час | 7 |
| Запросов в день | 15 |
| Авторизация | Не требуется (ограничение по IP) |
Endpoint: POST /api/public/demo/search
#Сравнение режимов аутентификации
Виджет поддерживает два режима аутентификации.
#Mode A — Доверять URL-зоне
Аутентификация на стороне клиента: вы сами отвечаете за то, кто попадает на страницы с виджетом (VPN, SSO, защищённые роуты). Lynkora не знает identity пользователя — только Origin/IP запроса. Виджет видят все, кто открывает страницу с embed-кодом.
- Бэкенд-код: 0 строк
- Время onboarding: ~2 минуты
- Подходит: intranet, internal portal
#Mode B — Session-токен (per-user JWT)
Ваш backend выпускает короткий session-токен на каждого пользователя. Lynkora знает identity, ведёт audit per user, поддерживает revocation и GDPR DSAR.
- Бэкенд-код: ~10 строк (через SDK)
- Время onboarding: 1–2 часа
- Подходит: multi-tenant SaaS, regulated industries
| Mode A — URL-зона | Mode B — Session-токен | |
|---|---|---|
| Identity пользователя | нет (только Origin/IP) | да (per-user JWT) |
| Audit per user | нет | да |
| Revocation / GDPR DSAR | нет | да |
| Бэкенд-код | 0 строк | ~10 строк (SDK) |
| Onboarding | ~2 минуты | 1–2 часа |