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

Verfügbarkeit nach Tarif. Die öffentliche API und das öffentliche Widget funktionieren nur in Tarifen, die sie enthalten (siehe Tarife und Abrechnung). In den übrigen Tarifen lässt sich kein Schlüssel und kein öffentliches Widget erstellen, und bereits ausgegebene antworten nicht mehr: Eine Anfrage mit dem Schlüssel erhält 403, die Widget-Schaltfläche erscheint nicht auf der Website. Das Unternehmens-Widget hängt von diesem Merkmal nicht ab.

#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://your-account.lynkora.pro/api/public/search \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "Как оформить отпуск?"}'

Antwort:

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

#Ratenlimits

API-Anfragen werden pro Schlüssel gedrosselt; bei Überschreitung wird HTTP 429 mit einem Retry-After-Header zurückgegeben.

#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 → Kanäle → Karte „JS Widget“ → „Widgets verwalten“ → „Widget erstellen“. Geben Sie die „Adresse der Website, auf der das Widget stehen wird“ an
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:

#Wo der Code in Website-Baukästen eingefügt wird

Der Code ist für alle Websites derselbe — Sie müssen ihn nicht ändern: Das Widget findet sich auf der Seite selbst, wo auch immer der Baukasten die Zeile einfügt. Der Unterschied liegt nur darin, wo Sie ihn einfügen.

Beliebige Website (HTML). Fügen Sie den Code vor dem schließenden </body>-Tag auf jeder Seite ein, auf der die Suche gebraucht wird — oder in die gemeinsame Vorlage der Website.

WordPress. Installieren Sie das Plugin WPCode (Insert Headers and Footers) → Code Snippets → Header & Footer → fügen Sie den Code in Footer ein → Save Changes. Auf WordPress.com sind Plugins nicht in jedem Tarif verfügbar.

Tilda. Für die gesamte Website: Site Settings → More → HTML code for the HEAD section → Code einfügen → Save → alle Seiten erneut veröffentlichen. Für eine einzelne Seite: Fügen Sie den Block Other → T123 (HTML code) hinzu und fügen Sie den Code darin ein.

Wix. Öffnen Sie im Dashboard der Website Settings → Custom Code (je nach Version der Oberfläche — unter „Advanced“ oder „Development & integrations“) → Add Custom Code → Code einfügen → All pages → Body — end → Apply. Verwenden Sie nicht das Element „Embed HTML“ auf einer Seite: Es wird in einem Frame unter einer anderen Adresse geöffnet, und das Widget funktioniert dort nicht. Eigener Code ist in Wix in einem Premium-Tarif mit verbundener Domain verfügbar.

Webflow. Site settings → Custom code → Footer code → Code einfügen → Save → Website veröffentlichen. Eigener Code für die gesamte Website ist in kostenpflichtigen Site-Tarifen verfügbar.

Squarespace. Öffnen Sie Code Injection (in den Website-Einstellungen; je nach Version der Oberfläche — unter Developer tools oder Website Tools) → fügen Sie den Code in Footer ein → Save. Code Injection ist nicht in jedem Tarif verfügbar.

Shopify. Online Store → Themes → … → Edit code → Datei layout/theme.liquid → Code vor </body> einfügen → Save.

Framer. Site Settings → General → Custom Code → Code in End of tag einfügen → Website veröffentlichen.

Google Tag Manager. Tags → New → Custom HTML → Code einfügen → Trigger All Pages → Save → Container mit Publish veröffentlichen.

Docusaurus. Der Code kommt in docusaurus.config.js, mit demselben Schlüssel:

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

Website-Adressen. Das Widget funktioniert nur unter den Adressen in Erlaubte Domains, und die Adresse wird exakt abgeglichen: example.com und www.example.com sind zwei verschiedene Adressen — fügen Sie beide hinzu. Wenn Sie die Website unter der Vorschauadresse des Baukastens testen (zum Beispiel *.tilda.ws, *.wixsite.com, *.webflow.io, *.myshopify.com), fügen Sie auch diese hinzu.

Die Schaltfläche ist nicht erschienen? Prüfen Sie drei Dinge: Das Widget ist aktiviert; die Seitenadresse steht in Erlaubte Domains — exakt, mit oder ohne www; der Code steht in den Website-Einstellungen oder in der Vorlage, nicht in einem Element, das der Baukasten in einem Frame öffnet.

#Widget-Parameter

#Ergebnis

In der Ecke Ihrer Website erscheint eine Schaltfläche (Farbe aus den Widget-Einstellungen). Klick → ein Chatfenster mit einem Fragefeld → eine KI-Antwort aus Ihrer Wissensdatenbank.

#Sprache

Der Besucher wechselt die Sprache mit der Globus-Schaltfläche im Kopf des Fensters; die Auswahl wird in seinem Browser für dieses Widget gespeichert. Ohne Auswahl nimmt das Widget die erste passende Sprache aus den Browsersprachen, dann die Sprache aus den Widget-Einstellungen (data-lang), dann Englisch. Die Sprache der Seite Ihrer Website wird nicht berücksichtigt. Auf Arabisch öffnet sich das Fenster von rechts nach links.

#Bindung an die Website

Das Widget funktioniert nur unter den Adressen, die beim Erstellen angegeben wurden („Adresse der Website, auf der das Widget stehen wird“); Anfragen von anderen Websites werden abgelehnt. Mehrere Adressen — durch Kommas getrennt. Ohne Adresse lässt sich das Widget nicht aktivieren, ein Sternchen für „jede Website“ wird nicht akzeptiert. Die Adresse wird exakt verglichen: example.com und www.example.com sind verschiedene Adressen — geben Sie beide an, wenn die Website unter beiden erreichbar ist. Für einen lokalen Test geben Sie die Adresse mit Port an, zum Beispiel http://127.0.0.1:8899.

#Was der Besucher sieht

• Im Antworttext gibt es keine Quellenmarkierungen wie [2.3]; Überschriften und Links sind formatiert.
• Unter der Antwort steht der Block „Quellen“: Der Link führt zur Originalseite und, falls es keine gibt, zum Artikel.
• Den Link „Vollständige Suche öffnen“ hat nur das Unternehmens-Widget.

#Wenn das KI-Antwortlimit ausgeschöpft ist

Das öffentliche Widget wird auf der Website vollständig ausgeblendet, bis das Limit zurückkehrt. Das Unternehmens-Widget bleibt sichtbar, nimmt aber keine Fragen an und zeigt, wann die Suche wieder verfügbar ist.

#iframe

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

#Einbettungscode

/embed ist die einzige Portaladresse, die in einem Frame auf einer fremden Website geöffnet werden darf. Die Portal-Startadresse (https://your-account.lynkora.pro) lässt sich nicht einbetten — der Browser verweigert dies. Der Frame benötigt keinen Schlüssel: Er arbeitet anonym und zeigt genau das, was ein anonymer Portalbesucher sieht; der Umfang stammt aus den Widget-Einstellungen.

#Direkter Link

Wenn ein iframe nicht zu Ihnen passt, geben Sie den Benutzern einen direkten Link: https://your-account.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