API e widget

Incorpori la ricerca AI di LiKE nelle Sue applicazioni, nel Suo sito web o nei sistemi interni. Tre metodi di integrazione: REST API, widget JS, iframe.

#REST API

#Passo 1 — Creare una chiave API

1. Integrazioni → API pubblica → "Crea chiave"
2. Inserisca un nome (ad esempio, "App mobile")
3. Copi la chiave — viene mostrata una sola volta

#Passo 2 — Usare l'API

Tutte le richieste sono autorizzate tramite l'header:

X-API-Key: your-key

#Endpoint principali

#Esempio: ricerca AI

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

Risposta:

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

#Limiti di frequenza

Le richieste API sono limitate per chiave. Il limite specifico dipende dal Suo piano; quando viene superato, viene restituito HTTP 429 con un header Retry-After. I valori esatti per il Suo piano si trovano nella sezione del piano.

#Sicurezza

1. Conservi le chiavi in variabili d'ambiente, non nel codice
2. Crei una chiave separata per ogni applicazione
3. Elimini le chiavi inutilizzate
4. Limiti i domini nelle impostazioni della chiave

#Widget JS

Un pulsante di ricerca AI fluttuante da incorporare in qualsiasi sito web.

#Passo 1 — Ottenere il codice

1. Integrazioni → Widget JS
2. Configuri i parametri (consulti la tabella seguente)
3. Copi il codice

#Passo 2 — Aggiungerlo al Suo sito

Inserisca lo <script> copiato prima del tag di chiusura </body>:

#Parametri del widget

#Risultato

Un pulsante viola appare nell'angolo del Suo sito. Clicchi → una finestra modale con una barra di ricerca → una risposta AI dalla Sua base di conoscenza.

#iframe

Un'interfaccia di ricerca completa incorporata nella Sua pagina:

#Codice di incorporamento

#Link diretto

Se un iframe non fa al caso Suo, fornisca agli utenti un link diretto: https://amedia.lynkora.pro

#Modalità demo

Per il test senza una chiave API, è disponibile un endpoint demo con limitazioni:

Endpoint: POST /api/public/demo/search

#Confronto delle modalità di autenticazione

Il widget supporta due modalità di autenticazione.

#Modalità A — Fiducia nella zona URL

Autenticazione lato client: Lei è responsabile di chi raggiunge le pagine con il widget (VPN, SSO, route protette). Lynkora non conosce l'identità dell'utente — solo l'Origin/IP della richiesta. Il widget è visibile a chiunque apra una pagina con il codice di incorporamento.

• Codice backend: 0 righe
• Tempo di onboarding: ~2 minuti
• Adatto per: intranet, portale interno

#Modalità B — Token di sessione (JWT per singolo utente)

Il Suo backend emette un token di sessione a breve durata per ogni utente. Lynkora conosce l'identità, mantiene un audit per singolo utente e supporta la revoca e le DSAR GDPR.

• Codice backend: ~10 righe (tramite SDK)
• Tempo di onboarding: 1–2 ore
• Adatto per: SaaS multi-tenant, settori regolamentati