API ja vidin

Lisage LiKE AI-otsing oma rakendustesse, veebilehele või sisesüsteemidesse. Integreerimiseks on kolm viisi: REST API, JS-vidin, iframe.

#REST API

Saadavus paketi järgi. Avalik API ja avalik vidin töötavad ainult pakettides, mis need sisaldavad (vt Paketid ja maksed). Teistes pakettides ei saa võtit ega avalikku vidinat luua ning juba väljastatud lakkavad vastamast: võtmega päring saab 403, vidina nupp veebilehel ei ilmu. Ettevõttesisene vidin sellest lipust ei sõltu.

#1. samm — looge API-võti

1. Integratsioonid → Public API → „Loo võti“
2. Sisestage nimi (näiteks „Mobiilirakendus“)
3. Kopeerige võti — seda näidatakse ainult ühe korra

#2. samm — kasutage API-t

Kõik päringud autoriseeritakse päisega:

X-API-Key: teie-võti

#Peamised otspunktid

#Näide: AI-otsing

curl -X POST https://your-account.lynkora.pro/api/public/search \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "Kuidas vormistada puhkust?"}'

Vastus:

{
  "answer": "Puhkuse vormistamiseks...",
  "sources": [
    {"title": "Puhkusepoliitika", "url": "..."}
  ]
}

#Päringusageduse piirang

Päringud API-le on iga võtme kaupa piiratud; piiri ületamisel tagastatakse HTTP 429 koos päisega Retry-After.

#Turvalisus

1. Hoidke võtmeid keskkonnamuutujates, mitte koodis
2. Looge igale rakendusele eraldi võti
3. Kustutage kasutuseta võtmed
4. Piirake võtme seadetes domeene

#JS-vidin

Hõljuv AI-otsingu nupp, mille saab lisada mis tahes veebilehele.

#1. samm — hankige kood

1. Integratsioonid → Kanalid → kaart „JS Widget“ → „Halda vidinaid“ → „Loo vidin“. Märkige „Veebilehe aadress, kus vidin hakkab olema“
2. Seadistage parameetrid (vt tabelit allpool)
3. Kopeerige kood

#2. samm — lisage veebilehele

Kleepige kopeeritud <script> enne sulgevat </body> silti:

#Kuhu kood saidiehitajates kleepida

Kood on kõigi saitide jaoks sama — seda pole vaja muuta: vidin leiab oma koha lehel ise, kuhu iganes saidiehitaja rea paigutab. Erinevus on ainult selles, kuhu see kleepida.

Mis tahes sait (HTML). Kleepige kood sulgeva sildi </body> ette igal lehel, kus otsingut vaja on, — või saidi ühisesse malli.

WordPress. Paigaldage plugin WPCode (Insert Headers and Footers) → Code Snippets → Header & Footer → kleepige kood välja Footer → Save Changes. WordPress.com-is ei ole pluginad kõigis pakettides saadaval.

Tilda. Kogu saidi jaoks: Site Settings → More → HTML code for the HEAD section → kleepige kood → Save → avaldage kõik lehed uuesti. Ühe lehe jaoks: lisage plokk Other → T123 (HTML code) ja kleepige kood sellesse.

Wix. Avage saidi juhtpaneelil Settings → Custom Code (sõltuvalt liidese versioonist — jaotises „Advanced“ või „Development & integrations“) → Add Custom Code → kleepige kood → All pages → Body — end → Apply. Ärge kasutage lehel elementi „Embed HTML“: see avaneb raamis teisel aadressil ja vidin seal ei tööta. Kohandatud kood on Wixis saadaval premium-paketis ühendatud domeeniga.

Webflow. Site settings → Custom code → Footer code → kleepige kood → Save → avaldage sait. Kogu saidi kohandatud kood on saadaval saidi tasulistes pakettides.

Squarespace. Avage Code Injection (saidi seadetes; sõltuvalt liidese versioonist — jaotises Developer tools või Website Tools) → kleepige kood välja Footer → Save. Koodi lisamine ei ole kõigis pakettides saadaval.

Shopify. Online Store → Themes → … → Edit code → fail layout/theme.liquid → kleepige kood sildi </body> ette → Save.

Framer. Site Settings → General → Custom Code → kleepige kood välja End of tag → avaldage sait.

Google Tag Manager. Tags → New → Custom HTML → kleepige kood → päästik All Pages → Save → avaldage konteiner nupuga Publish.

Docusaurus. Kood lisatakse faili docusaurus.config.js, sama võtmega:

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

Saidi aadressid. Vidin töötab ainult väljal Lubatud päritolud (origins) loetletud aadressidel ja aadressi võrreldakse täpselt: example.com ja www.example.com on kaks eri aadressi — lisage mõlemad. Kui testite saiti saidiehitaja eelvaate aadressil (näiteks *.tilda.ws, *.wixsite.com, *.webflow.io, *.myshopify.com), lisage ka see.

Nupp ei ilmunud? Kontrollige kolme asja: vidin on sisse lülitatud; lehe aadress on väljal Lubatud päritolud (origins) — täpselt, www-ga või ilma; kood on saidi seadetes või mallis, mitte elemendis, mille saidiehitaja avab raamis.

#Vidina parameetrid

#Tulemus

Teie veebilehe nurka ilmub nupp (värv tuleb vidina seadetest). Klõps → vestlusaken küsimuse väljaga → AI-vastus teie teadmusbaasist.

#Keel

Külastaja vahetab keelt akna päises oleva gloobusenupuga; valik jääb tema brauserisse selle vidina jaoks meelde. Ilma valikuta võtab vidin esimese sobiva brauseri keeltest, seejärel vidina seadete keele (data-lang), seejärel inglise keele. Teie veebilehe keelt arvesse ei võeta. Araabia keeles avaneb aken paremalt vasakule.

#Seotus veebilehega

Vidin töötab ainult aadressidel, mis loomisel märgiti („Veebilehe aadress, kus vidin hakkab olema“); muudelt lehtedelt päringud lükatakse tagasi. Mitu aadressi eraldatakse komaga. Ilma aadressita vidinat sisse lülitada ei saa, tärni „mis tahes veebileht“ ei aktsepteerita. Aadressi võrreldakse täpselt: example.com ja www.example.com on eri aadressid — märkige mõlemad, kui leht avaneb mõlemal. Kohalikuks kontrolliks märkige aadress koos pordiga, näiteks http://127.0.0.1:8899.

#Mida külastaja näeb

• Vastuse tekstis pole allikamärgiseid kujul [2.3]; pealkirjad ja lingid on vormistatud.
• Vastuse all on plokk „Allikad“: link viib algallika lehele, ja kui seda pole — artiklile.
• Link „Ava täisotsing“ on ainult ettevõttesisesel vidinal.

#Kui AI-vastuste limiit on täis

Avalik vidin peidetakse veebilehelt täielikult, kuni limiit taastub. Ettevõttesisene vidin jääb oma kohale, kuid ei võta küsimusi vastu ja näitab, millal otsing taas saadavaks muutub.

#iframe

Täielik otsinguliides, mis on lisatud teie lehele:

#Lisamise kood

/embed on portaali ainus aadress, mida tohib avada raamis võõral veebilehel. Portaali juurt (https://your-account.lynkora.pro) lisada ei saa: brauser keeldub. Raam võtit ei vaja — see töötab anonüümselt ja näitab täpselt seda, mida näeb portaali anonüümne külastaja; ala võetakse vidina seadetest.

#Otselink

Kui iframe ei sobi — andke kasutajatele otselink: https://your-account.lynkora.pro

#Demorežiim

Ilma API-võtmeta katsetamiseks on saadaval demo-otspunkt piirangutega:

Otspunkt: POST /api/public/demo/search

#Autentimisrežiimide võrdlus

Vidin toetab kahte autentimisrežiimi.

#Režiim A — usaldada URL-i tsooni

Autentimine käib kliendi poolel: te vastutate ise selle eest, kes vidinaga lehtedele satub (VPN, SSO, kaitstud marsruudid). Lynkora ei tea kasutaja identiteeti — ainult päringu Origin/IP. Vidinat näevad kõik, kes avavad lehe, kus manustamiskood asub.

• Serveripoolset koodi: 0 rida
• Kasutuselevõtu aeg: ~2 minutit
• Sobib: sisevõrk, siseportaal

#Režiim B — seansimärgis (kasutajapõhine JWT)

Teie server väljastab lühikese seansimärgise iga kasutaja kohta. Lynkora teab identiteeti, peab kasutajapõhist auditit, toetab tühistamist ja GDPR-i andmesubjekti päringuid.

• Serveripoolset koodi: ~10 rida (SDK kaudu)
• Kasutuselevõtu aeg: 1–2 tundi
• Sobib: mitme kliendiga SaaS, reguleeritud valdkonnad