Уградите LiKE AI претрагу у своје апликације, веб-сајт или интерне системе. Три метода интеграције: REST API, JS виџет, iframe.

#REST API

#Корак 1 — Креирајте API кључ

  1. Интеграције → Public API → „Креирај кључ”
  2. Унесите назив (на пример, „Мобилна апликација”)
  3. Копирајте кључ — приказује се само једном

#Корак 2 — Користите API

Сви захтеви се ауторизују преко заглавља:

X-API-Key: your-key

#Основне крајње тачке

Крајња тачка Метод Опис
/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": "..."}
  ]
}

#Ограничења брзине

API захтеви су ограничени по кључу. Конкретно ограничење зависи од вашег плана; када се премаши, враћа се HTTP 429 са заглављем Retry-After. Тачне вредности за ваш план су у одељку плана.

#Безбедност

  1. Чувајте кључеве у променљивама окружења, не у коду
  2. Креирајте засебан кључ за сваку апликацију
  3. Обришите некоришћене кључеве
  4. Ограничите домене у подешавањима кључа

#JS виџет

Плутајуће дугме за AI претрагу за уграђивање на било који веб-сајт.

#Корак 1 — Преузмите код

  1. Интеграције → JS Widget
  2. Конфигуришите параметре (види табелу испод)
  3. Копирајте код

#Корак 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 Опционо. Токен сесије за режим идентитета по кориснику (види „Поређење режима аутентификације” испод)

#Резултат

Љубичасто дугме се појављује у углу вашег сајта. Кликните → модални прозор са траком за претрагу → AI одговор из ваше базе знања.

#iframe

Потпуно функционалан интерфејс за претрагу уграђен на вашу страницу:

#Код за уграђивање

#Директан линк

Ако вам iframe не одговара, дајте корисницима директан линк: https://amedia.lynkora.pro

#Демо режим

За тестирање без API кључа, доступна је демо крајња тачка са ограничењима:

Параметар Вредност
Захтева на сат 7
Захтева на дан 15
Ауторизација Није потребна (ограничено по IP)

Крајња тачка: POST /api/public/demo/search

#Поређење режима аутентификације

Виџет подржава два режима аутентификације.

#Режим А — Поверење URL зони

Аутентификација на страни клијента: ви сте одговорни за то ко долази до страница са виџетом (VPN, SSO, заштићене руте). Lynkora не зна идентитет корисника — само Origin/IP захтева. Виџет је видљив свима који отворе страницу са кодом за уграђивање.

  • Backend код: 0 линија
  • Време онбординга: ~2 минута
  • Погодно за: интранет, интерни портал

#Режим Б — Токен сесије (JWT по кориснику)

Ваш backend издаје краткотрајни токен сесије за сваког корисника. Lynkora зна идентитет, води ревизију по кориснику и подржава опозив и GDPR DSAR.

  • Backend код: ~10 линија (преко SDK-а)
  • Време онбординга: 1–2 сата
  • Погодно за: multi-tenant SaaS, регулисане индустрије
Режим А — URL зона Режим Б — Токен сесије
Идентитет корисника не (само Origin/IP) да (JWT по кориснику)
Ревизија по кориснику не да
Опозив / GDPR DSAR не да
Backend код 0 линија ~10 линија (SDK)
Онбординг ~2 минута 1–2 сата