API et widget

Intégrez la recherche IA de LiKE dans vos applications, votre site web ou vos systèmes internes. Trois méthodes d'intégration : API REST, widget JS, iframe.

#API REST

#Étape 1 — Créer une clé API

1. Intégrations → API publique → « Créer une clé »
2. Saisissez un nom (par exemple, « Application mobile »)
3. Copiez la clé — elle n'est affichée qu'une seule fois

#Étape 2 — Utiliser l'API

Toutes les requêtes sont autorisées via l'en-tête :

X-API-Key: your-key

#Endpoints principaux

#Exemple : recherche IA

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

Réponse :

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

#Limites de débit

Les requêtes API sont limitées par clé. La limite précise dépend de votre plan ; en cas de dépassement, une HTTP 429 est renvoyée avec un en-tête Retry-After. Les valeurs exactes pour votre plan se trouvent dans la section du plan.

#Sécurité

1. Stockez les clés dans des variables d'environnement, pas dans le code
2. Créez une clé distincte pour chaque application
3. Supprimez les clés inutilisées
4. Restreignez les domaines dans les paramètres de la clé

#Widget JS

Un bouton flottant de recherche IA à intégrer sur n'importe quel site web.

#Étape 1 — Obtenir le code

1. Intégrations → Widget JS
2. Configurez les paramètres (voir le tableau ci-dessous)
3. Copiez le code

#Étape 2 — L'ajouter à votre site

Insérez le <script> copié avant la balise fermante </body> :

#Paramètres du widget

#Résultat

Un bouton violet apparaît dans le coin de votre site. Cliquez → une fenêtre modale avec une barre de recherche → une réponse IA issue de votre base de connaissances.

#iframe

Une interface de recherche complète intégrée sur votre page :

#Code d'intégration

#Lien direct

Si une iframe ne vous convient pas, donnez aux utilisateurs un lien direct : https://amedia.lynkora.pro

#Mode démo

Pour les tests sans clé API, un endpoint de démonstration est disponible avec des limitations :

Endpoint : POST /api/public/demo/search

#Comparaison des modes d'authentification

Le widget prend en charge deux modes d'authentification.

#Mode A — Faire confiance à la zone d'URL

Authentification côté client : vous êtes responsable de qui atteint les pages contenant le widget (VPN, SSO, routes protégées). Lynkora ne connaît pas l'identité de l'utilisateur — seulement l'Origin/IP de la requête. Le widget est visible par tous ceux qui ouvrent une page avec le code d'intégration.

• Code backend : 0 ligne
• Temps de mise en place : ~2 minutes
• Adapté à : intranet, portail interne

#Mode B — Jeton de session (JWT par utilisateur)

Votre backend émet un jeton de session à courte durée de vie pour chaque utilisateur. Lynkora connaît l'identité, tient un audit par utilisateur et prend en charge la révocation et les DSAR RGPD.

• Code backend : ~10 lignes (via le SDK)
• Temps de mise en place : 1 à 2 heures
• Adapté à : SaaS multi-tenant, secteurs réglementés