Connecteur Wikit Semantics JSON API

Configuration du connecteur

Grâce à l'interfaçage entre Wikit Semantics et votre webhook, votre app Wikit Semantics permet à vos utilisateurs de pouvoir exploiter des contenus de base, de connaissance, d'espace documentaires, etc. Le connecteur synchronise les contenus renvoyés par les webhooks et points de terminaison REST au format JSON de Wikit Semantics vers une source de données Wikit Semantics.

Nom du champ	Format / Type	Obligatoire	Commentaire
URL du webhook	URL	✅	URL du point de terminaison REST renvoyant le contenu au format JSON Wikit Semantics
Entête HTTP Authorization	Texte libre / Token	➖	Entête d'autorisation transmis lors de l'appel au webhook (par exemple : Basic <secret-encodé> ou Bearer <jeton-jwt>)

💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.

Fonctionnement du connecteur

Ce format permet de décrire des documents avec leurs contenus fragmentés (chunks) dans un standard de fait pour la solution Wikit Semantics.

Exemple de flux JSON :

[
  {
    "@context": "https://wikit.ai",
    "@type": "Document",
    "identifier": "document-1",
    "title": "Mon Document",
    "url": "https://example.com/document-1",
    "dateModified": "2025-05-13T00:00:00.000Z",
    "hasPart": [
      {
        "@type": "DocumentChunk",
        "text": "# Introduction Ceci est le premier paragraphe."
      },
      {
        "@type": "DocumentChunk",
        "text": "# Chapitre 1 Contenu du chapitre 1."
      },
      { "@type": "DocumentChunk", "text": "# Conclusion Résumé final." }
    ]
  },
  {
    "@context": "https://wikit.ai",
    "@type": "Document",
    "identifier": "document-2",
    "title": "Mon second Document",
    "url": "https://example.com/document-2",
    "dateModified": "2025-05-13T00:00:00.000Z",
    "hasPart": [
      { "@type": "DocumentChunk", "text": "Ceci est un court document." }
    ]
  }
]

À noter pour le bon fonctionnement de la synchronisation :

• Les champs identifier, dateModified et hasPart sont indispensables pour la synchronisation. La date de dernière modification est utilisée pour remplacer les documents mis à jour depuis la précédente synchronisation opérée par le connecteur.
• Les champs title et url sont recommandés pour une meilleure exploitation des contenus dans Wikit Semantics Chat.