API и виџет

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

#REST API

Доступност по плану. Јавни API и јавни виџет раде само на плановима који их укључују (види Планови и наплата). На осталим плановима не може се креирати кључ или јавни виџет, а већ издати престају да одговарају: захтев преко кључа добија 403, дугме виџета се не појављује на сајту. Корпоративни виџет не зависи од ове ознаке.

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

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

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

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

X-API-Key: your-key

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

#Пример: AI претрага

curl -X POST https://your-account.lynkora.pro/api/public/search \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "Как оформить отпуск?"}'

Одговор:

{
  "answer": "Для оформления отпуска...",
  "sources": [
    {"title": "Политика отпусков", "url": "..."}
  ]
}

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

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

#Безбедност

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

#JS виџет

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

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

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

#Корак 2 — Додајте га на свој сајт

Уметните копирани <script> пре затварајуће ознаке </body>:

#Где налепити код у конструкторима сајтова

Код је исти за све сајтове — не треба га мењати: виџет сам проналази своје место на страници, где год конструктор постави ред. Разлика је само у томе где га налепити.

Било који сајт (HTML). Налепите код пре затварајуће ознаке </body> на свакој страници на којој је потребна претрага — или у заједнички шаблон сајта.

WordPress. Инсталирајте плугин WPCode (Insert Headers and Footers) → Code Snippets → Header & Footer → налепите код у поље Footer → Save Changes. На WordPress.com плугинови нису доступни на свим плановима.

Tilda. За цео сајт: Site Settings → More → HTML code for the HEAD section → налепите код → Save → поново објавите све странице. За једну страницу: додајте блок Other → T123 (HTML code) и налепите код у њега.

Wix. У контролној табли сајта отворите Settings → Custom Code (у зависности од верзије интерфејса — у одељку „Advanced“ или „Development & integrations“) → Add Custom Code → налепите код → All pages → Body — end → Apply. Не користите елемент „Embed HTML“ на страници: он се отвара у оквиру (frame) на другој адреси и виџет тамо неће радити. Прилагођени код у Wix-у доступан је на премијум плану са повезаним доменом.

Webflow. Site settings → Custom code → Footer code → налепите код → Save → објавите сајт. Прилагођени код за цео сајт доступан је на плаћеним плановима сајта.

Squarespace. Отворите Code Injection (у подешавањима сајта; у зависности од верзије интерфејса — у одељку Developer tools или Website Tools) → налепите код у поље Footer → Save. Уметање кода није доступно на свим плановима.

Shopify. Online Store → Themes → … → Edit code → фајл layout/theme.liquid → налепите код пре </body> → Save.

Framer. Site Settings → General → Custom Code → налепите код у поље End of tag → објавите сајт.

Google Tag Manager. Tags → New → Custom HTML → налепите код → окидач All Pages → Save → објавите контејнер дугметом Publish.

Docusaurus. Код се наводи у docusaurus.config.js, са истим кључем:

scripts: [
  {
    src: 'https://your-account.lynkora.pro/api/public/widget.js',
    'data-key': 'wk_live_YOUR_KEY',
    async: true,
  },
],

Адресе сајта. Виџет ради само на адресама из поља Дозвољени домени, а адреса се проверава тачно: example.com и www.example.com су две различите адресе — додајте обе. Ако сајт проверавате на адреси за преглед у конструктору (на пример *.tilda.ws, *.wixsite.com, *.webflow.io, *.myshopify.com), додајте и њу.

Дугме се није појавило? Проверите три ствари: виџет је омогућен; адреса странице је у пољу Дозвољени домени — тачно, са www или без; код стоји у подешавањима сајта или шаблону, а не у елементу који конструктор отвара у оквиру.

#Параметри виџета

#Резултат

Дугме се појављује у углу вашег сајта (боја — из подешавања виџета). Кликните → прозор ћаскања са пољем за питање → AI одговор из ваше базе знања.

#Језик

Посетилац мења језик дугметом са глобусом у заглављу прозора; избор се памти у његовом прегледачу за овај виџет. Без избора виџет узима први одговарајући међу језицима прегледача, затим језик из подешавања виџета (data-lang), затим енглески. Језик странице вашег сајта се не узима у обзир. На арапском се прозор отвара здесна налево.

#Везивање за сајт

Виџет ради само на адресама наведеним при креирању („Адреса сајта на којем ће стајати виџет“); захтеви са других сајтова се одбијају. Више адреса — одвојене зарезом. Без адресе виџет не може да се укључи, звездица „било који сајт“ се не прихвата. Адреса се пореди тачно: example.com и www.example.com су различите адресе, наведите обе ако се сајт отвара на обе. За локалну проверу наведите адресу са портом, на пример http://127.0.0.1:8899.

#Шта посетилац види

• У тексту одговора нема ознака извора облика [2.3]; наслови и линкови су форматирани.
• Испод одговора — блок „Извори“: линк води на изворну страницу, а ако ње нема — на чланак.
• Линк „Отвори потпуну претрагу“ постоји само код корпоративног виџета.

#Ако је ограничење AI одговора исцрпљено

Јавни виџет се на сајту у потпуности скрива док се ограничење не врати. Корпоративни виџет остаје на месту, али не прима питања и приказује када ће претрага поново бити доступна.

#iframe

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

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

/embed је једина адреса портала коју је дозвољено отворити у оквиру на туђем сајту. Корен портала (https://your-account.lynkora.pro) не може да се угради — прегледач ће то одбити. Оквиру није потребан кључ: ради анонимно и приказује тачно оно што види анонимни посетилац портала; опсег се преузима из подешавања виџета.

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

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

#Демо режим

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

Крајња тачка: 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, регулисане индустрије