API und Widget

Betten Sie die KI-Suche von LiKE in Ihre Anwendungen, Ihre Website oder Ihre internen Systeme ein. Drei Integrationsmethoden: REST API, JS-Widget, iframe.

#REST API

#Schritt 1 — Einen API-Schlüssel erstellen

1. Integrationen → Public API → „Schlüssel erstellen“
2. Geben Sie einen Namen ein (zum Beispiel „Mobile App“)
3. Kopieren Sie den Schlüssel — er wird nur einmal angezeigt

#Schritt 2 — Die API verwenden

Alle Anfragen werden über den Header autorisiert:

X-API-Key: your-key

#Kern-Endpoints

#Beispiel: KI-Suche

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

Antwort:

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

#Ratenlimits

API-Anfragen werden pro Schlüssel gedrosselt. Das konkrete Limit hängt von Ihrem Tarif ab; bei Überschreitung wird HTTP 429 mit einem Retry-After-Header zurückgegeben. Die genauen Werte für Ihren Tarif finden Sie im Tarifbereich.

#Sicherheit

1. Speichern Sie Schlüssel in Umgebungsvariablen, nicht im Code
2. Erstellen Sie einen separaten Schlüssel für jede Anwendung
3. Löschen Sie nicht verwendete Schlüssel
4. Beschränken Sie die Domains in den Schlüsseleinstellungen

#JS-Widget

Eine schwebende KI-Suchschaltfläche zum Einbetten auf jeder beliebigen Website.

#Schritt 1 — Den Code abrufen

1. Integrationen → JS Widget
2. Konfigurieren Sie die Parameter (siehe die Tabelle unten)
3. Kopieren Sie den Code

#Schritt 2 — Auf Ihrer Website einfügen

Fügen Sie das kopierte <script> vor dem schließenden </body>-Tag ein:

#Widget-Parameter

#Ergebnis

In der Ecke Ihrer Website erscheint eine violette Schaltfläche. Klick → ein modales Fenster mit einer Suchleiste → eine KI-Antwort aus Ihrer Wissensdatenbank.

#iframe

Eine voll funktionsfähige Suchoberfläche, eingebettet auf Ihrer Seite:

#Einbettungscode

#Direkter Link

Wenn ein iframe nicht zu Ihnen passt, geben Sie den Benutzern einen direkten Link: https://amedia.lynkora.pro

#Demo-Modus

Zum Testen ohne API-Schlüssel steht ein Demo-Endpoint mit Einschränkungen zur Verfügung:

Endpoint: POST /api/public/demo/search

#Vergleich der Authentifizierungsmodi

Das Widget unterstützt zwei Authentifizierungsmodi.

#Modus A — Der URL-Zone vertrauen

Clientseitige Authentifizierung: Sie sind dafür verantwortlich, wer die Seiten mit dem Widget erreicht (VPN, SSO, geschützte Routen). Lynkora kennt die Identität des Benutzers nicht — nur den Origin/IP der Anfrage. Das Widget ist für jeden sichtbar, der eine Seite mit dem Einbettungscode öffnet.

• Backend-Code: 0 Zeilen
• Onboarding-Zeit: ~2 Minuten
• Geeignet für: Intranet, internes Portal

#Modus B — Sitzungstoken (benutzerbezogenes JWT)

Ihr Backend stellt für jeden Benutzer ein kurzlebiges Sitzungstoken aus. Lynkora kennt die Identität, führt ein Audit pro Benutzer und unterstützt Widerruf und DSGVO-DSAR.

• Backend-Code: ~10 Zeilen (über SDK)
• Onboarding-Zeit: 1–2 Stunden
• Geeignet für: Multi-Tenant-SaaS, regulierte Branchen