Documentation

Français

English

Français

English

CHANGELOG ​

  • 8 juillet 2025 [Release:2507] : Changement des routes liées aux documents

    Impact sur les routes :

    • Liste des documents
    • Ajout de document(s)
    • Consultation des métadonnées d’un document
    • Suppression d’un document

  • 24 octobre 2025 : Rajout des routes liées aux sources de données

  • 5 février 2026 : Nouvelle route de citation de sources

Introduction ​

Cette page a pour objectif d’expliquer les grands principes d’intégration de la solution Wikit Semantics selon deux axes :

  • L’exécution de requêtes sur les Apps LLM “Question-Réponse”
  • L’administration des sources de données pour les Apps LLM “Question-Réponse”

Elle porte uniquement sur l’API REST Wikit Semantics associée à ces deux points.

Cette documentation est à destination de tout intégrateur logiciel souhaitant bénéficier de l’IA Générative dans une solution tierce ou un système d’information externe.

Authentification et autorisation ​

Deux mécanismes d’authentification & autorisation sont mises en œuvre :

  • Clé d’API pour l’API d’exécution de requêtes disponible a la demande
  • OAuth2 pour l’API d’administration

Authentification pour l’API d’administraion ​

L’authentification sur l’API d’administration Wikit Semantics est fondée sur le service transversale d’IAM de Wikit.

Le service d’authentification et d’autorisation implémente OpenID Connect qui utilise les mécanismes d'OAuth2.

La génération de jetons OAuth2 est réalisé avec l’utilisation des informations suivantes :

  • Realm : wikit-prod
  • Identifiant client : semantics-console
  • Informations de connexion : identifiant / mot de passe du compte utilisateur avec accès à l’API.
bash
curl -L -X POST 'https://auth.wikit.ai/realms/wikit-prod/protocol/openid-connect/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode "client_id=semantics-console" \
  --data-urlencode "grant_type=password" \
  --data-urlencode "username=$SEMANTICS_USERNAME" \
  --data-urlencode "password=$SEMANTICS_PASSWORD"

Contact ​

Pour toute question, contactez l’équipe support (support@wikit.ai) ou votre interlocuteur Wikit habituel.