{"id":7485,"date":"2026-08-19T19:10:09","date_gmt":"2026-08-19T19:10:09","guid":{"rendered":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/integrations\/api\/"},"modified":"2026-11-09T16:24:35","modified_gmt":"2026-11-09T16:24:35","slug":"api","status":"publish","type":"wvn_doc","link":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/integrations\/api\/","title":{"rendered":"API developer"},"content":{"rendered":"<h1>API developer<\/h1>\n<p>Une API HTTP permet d&rsquo;int\u00e9grer WivenLLM \u00e0 vos applications : alimenter des espaces, poser des questions, g\u00e9rer les utilisateurs, exploiter les conversations.<\/p>\n<p>Disponible en d\u00e9ploiement serveur ou h\u00e9berg\u00e9. Sur l&rsquo;application de poste de travail, elle ne r\u00e9pond que depuis la machine elle-m\u00eame.<\/p>\n<hr \/>\n<h2>Authentication<\/h2>\n<p>Cr\u00e9ez une cl\u00e9 dans R\u00e9glages \u2192 S\u00e9curit\u00e9 \u2192 Cl\u00e9s API. Elle n&rsquo;est affich\u00e9e qu&rsquo;\u00e0 la cr\u00e9ation.<\/p>\n<p>Chaque requ\u00eate porte la cl\u00e9 dans l&rsquo;en-t\u00eate Authorization :<\/p>\n<pre><code>Authorization: Bearer VOTRE_CLE_API<\/code><\/pre>\n<p><strong>Une cl\u00e9 donne un acc\u00e8s complet \u00e0 l&rsquo;API<\/strong>, y compris \u00e0 la configuration de l&rsquo;instance. Cr\u00e9ez-en une par int\u00e9gration, r\u00e9voquez ce qui ne sert plus, et ne les publiez jamais dans du code partag\u00e9. Cr\u00e9ations et suppressions de cl\u00e9s sont journalis\u00e9es.<\/p>\n<p><strong>Une cl\u00e9 agit pour l&rsquo;instance, sans personne derri\u00e8re.<\/strong> Elle n&rsquo;est li\u00e9e \u00e0 aucun utilisateur et n&rsquo;a pas de port\u00e9e par espace. Elle voit tous les documents, y compris ceux r\u00e9serv\u00e9s \u00e0 des personnes nomm\u00e9es. Traitez-la en cons\u00e9quence : l&rsquo;application qui la d\u00e9tient doit filtrer elle-m\u00eame ce qu&rsquo;elle montre \u00e0 ses utilisateurs.<\/p>\n<p><strong>Quota and flow rate.<\/strong> Le quota quotidien de messages d&rsquo;un utilisateur ne s&rsquo;applique pas \u00e0 l&rsquo;API. Seule une limite de d\u00e9bit s&rsquo;y applique : 600 requ\u00eates par 15 minutes et par cl\u00e9, r\u00e9glable \u00e0 l&rsquo;installation.<\/p>\n<hr \/>\n<h2>Interactive documentation<\/h2>\n<p>Une documentation d&rsquo;API interactive est servie par l&rsquo;instance elle-m\u00eame. Elle liste tous les points d&rsquo;entr\u00e9e avec leurs param\u00e8tres et permet de les essayer. C&rsquo;est la r\u00e9f\u00e9rence \u00e0 jour de votre version.<\/p>\n<p>It can be disabled in production.<\/p>\n<hr \/>\n<h2>Main entry points<\/h2>\n<p>L&rsquo;API couvre l&rsquo;essentiel de l&rsquo;application. Les familles de points d&rsquo;entr\u00e9e :<\/p>\n<table>\n<thead>\n<tr>\n<th>Family<\/th>\n<th>Ce qu&rsquo;elle permet<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>Workspaces<\/strong><\/td>\n<td>Lister, cr\u00e9er, r\u00e9gler et supprimer des espaces ; ajouter ou retirer des documents d&rsquo;un espace ; \u00e9pingler un document<\/td>\n<\/tr>\n<tr>\n<td><strong>Conversation<\/strong><\/td>\n<td>Poser une question \u00e0 un espace, en r\u00e9ponse compl\u00e8te ou en flux continu ; lire l&rsquo;historique ; lancer une recherche documentaire seule, sans g\u00e9n\u00e9ration<\/td>\n<\/tr>\n<tr>\n<td><strong>Discussion thread<\/strong><\/td>\n<td>Create a thread, write in it, read its history, delete it<\/td>\n<\/tr>\n<tr>\n<td><strong>Documents<\/strong><\/td>\n<td>Upload a file, import a URL, inject plain text, list accepted documents and formats, organize folders<\/td>\n<\/tr>\n<tr>\n<td><strong>Administration<\/strong><\/td>\n<td>Utilisateurs, invitations, membres des espaces et conversations de l&rsquo;instance (mode multi-utilisateurs)<\/td>\n<\/tr>\n<tr>\n<td><strong>Widgets, system, tickets<\/strong><\/td>\n<td>Gestion des widgets et de leurs conversations, informations sur l&rsquo;instance, export des conversations, tickets de rappel internes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Chaque requ\u00eate de conversation pr\u00e9cise l&rsquo;espace de travail et le <strong>fashion<\/strong> (<code>cat<\/code>, <code>query<\/code> Or <code>automatic<\/code>The response contains the generated text and the sources used. Document research alone is useful when you want to find relevant passages and process them yourself, without using a template.<\/p>\n<p><strong>Reminder :<\/strong> t\u00e9l\u00e9verser ne rend pas un document interrogeable. Il faut ensuite l&rsquo;ajouter \u00e0 un espace de travail.<\/p>\n<p>A message prefixed by <code>@agent<\/code> lance un agent, en un seul \u00e9change. Personne ne peut alors r\u00e9pondre \u00e0 une carte d&rsquo;approbation : toute action qui en demande une est refus\u00e9e, sauf si elle a \u00e9t\u00e9 approuv\u00e9e d&rsquo;avance. Les actions sans approbation (requ\u00eates SQL, outils MCP, flux) s&rsquo;ex\u00e9cutent normalement.<\/p>\n<p>La liste compl\u00e8te des points d&rsquo;entr\u00e9e, avec leurs param\u00e8tres, figure dans la documentation interactive de votre instance.<\/p>\n<hr \/>\n<h2>OpenAI compatibility<\/h2>\n<p>Un jeu de points d&rsquo;entr\u00e9e reproduit l&rsquo;interface du standard OpenAI : compl\u00e9tion de conversation, embeddings, liste des mod\u00e8les, g\u00e9n\u00e9ration d&rsquo;images et magasins de vecteurs.<\/p>\n<p>L&rsquo;int\u00e9r\u00eat : une application d\u00e9j\u00e0 \u00e9crite pour ce standard fonctionne avec WivenLLM en changeant l&rsquo;adresse de base et la cl\u00e9. Le nom du mod\u00e8le correspond \u00e0 l&rsquo;espace de travail \u00e0 interroger, ce qui permet de b\u00e9n\u00e9ficier de son contexte documentaire.<\/p>\n<p>C&rsquo;est le chemin le plus court pour brancher un outil existant sur votre base documentaire priv\u00e9e.<\/p>\n<p><strong>Le prompt syst\u00e8me du client remplace celui de l&rsquo;espace.<\/strong> If the request contains a message <code>system<\/code>, il prend enti\u00e8rement la place du prompt syst\u00e8me de l&rsquo;espace : les consignes que vous y avez \u00e9crites ne s&rsquo;appliquent plus. Sans message <code>system<\/code>, c&rsquo;est le prompt de l&rsquo;espace qui est utilis\u00e9. L&rsquo;application cliente d\u00e9cide donc du comportement de l&rsquo;assistant.<\/p>\n<p>Ces points d&rsquo;entr\u00e9e ne d\u00e9clenchent pas d&rsquo;agent : <code>@agent<\/code> et les comp\u00e9tences n&rsquo;y sont pas disponibles. L&rsquo;historique est celui que le client envoie.<\/p>\n<hr \/>\n<h2>Best practices for integration<\/h2>\n<p><strong>One space per use.<\/strong> Isolate areas exposed to an application from areas used by your employees.<\/p>\n<p><strong>One thread per end user.<\/strong> If your application serves multiple users, create a separate thread for each user: contexts won't mix. The setting <code>sessionId<\/code> s\u00e9pare aussi les historiques sans cr\u00e9er de fil. Ni l&rsquo;un ni l&rsquo;autre ne restreint les documents accessibles.<\/p>\n<p><strong>Process the mode.<\/strong> The parameter <code>fashion<\/code> (<code>cat<\/code>, <code>query<\/code> Or <code>automatic<\/code>) is crucial for integration: <code>query<\/code> \u00e9vite les r\u00e9ponses invent\u00e9es quand la base ne contient pas l&rsquo;information.<\/p>\n<p><strong>Manage errors and latency.<\/strong> Une r\u00e9ponse peut prendre plusieurs secondes, davantage avec un agent. Pr\u00e9voyez des d\u00e9lais d&rsquo;attente adapt\u00e9s et un traitement des \u00e9checs du fournisseur de mod\u00e8le.<\/p>\n<p><strong>Use continuous flow<\/strong> pour toute interface o\u00f9 un humain attend : la r\u00e9ponse s&rsquo;affiche \u00e0 mesure, l&rsquo;attente per\u00e7ue est bien moindre.<\/p>\n<p><strong>Utilize the sources.<\/strong> Les r\u00e9ponses renvoient les extraits utilis\u00e9s : affichez-les, c&rsquo;est ce qui rend l&rsquo;int\u00e9gration v\u00e9rifiable.<\/p>","protected":false},"parent":7452,"menu_order":602,"template":"","meta":[],"class_list":["post-7485","wvn_doc","type-wvn_doc","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>API d\u00e9veloppeur \u2014 Documentation WivenLLM<\/title>\n<meta name=\"description\" content=\"Piloter WivenLLM depuis vos applications \u2014 authentification, principaux points d&#039;entr\u00e9e et compatibilit\u00e9 OpenAI.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/integrations\/api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API d\u00e9veloppeur \u2014 Documentation WivenLLM\" \/>\n<meta property=\"og:description\" content=\"Piloter WivenLLM depuis vos applications \u2014 authentification, principaux points d&#039;entr\u00e9e et compatibilit\u00e9 OpenAI.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/integrations\/api\/\" \/>\n<meta property=\"og:site_name\" content=\"Wiven AI\" \/>\n<meta property=\"article:modified_time\" content=\"2026-11-09T16:24:35+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/integrations\\\/api\\\/\",\"url\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/integrations\\\/api\\\/\",\"name\":\"API d\u00e9veloppeur \u2014 Documentation WivenLLM\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/#website\"},\"datePublished\":\"2026-08-19T19:10:09+00:00\",\"dateModified\":\"2026-11-09T16:24:35+00:00\",\"description\":\"Piloter WivenLLM depuis vos applications \u2014 authentification, principaux points d'entr\u00e9e et compatibilit\u00e9 OpenAI.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/integrations\\\/api\\\/#breadcrumb\"},\"inLanguage\":\"en\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/integrations\\\/api\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/integrations\\\/api\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Int\u00e9grations\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/integrations\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"API d\u00e9veloppeur\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/#website\",\"url\":\"https:\\\/\\\/www.wiven.ai\\\/\",\"name\":\"Wiven AI\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.wiven.ai\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Developer API \u2014 WivenLLM Documentation","description":"Control WivenLLM from your applications \u2014 authentication, main entry points and OpenAI compatibility.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/integrations\/api\/","og_locale":"en_US","og_type":"article","og_title":"API d\u00e9veloppeur \u2014 Documentation WivenLLM","og_description":"Piloter WivenLLM depuis vos applications \u2014 authentification, principaux points d'entr\u00e9e et compatibilit\u00e9 OpenAI.","og_url":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/integrations\/api\/","og_site_name":"Wiven AI","article_modified_time":"2026-11-09T16:24:35+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/integrations\/api\/","url":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/integrations\/api\/","name":"Developer API \u2014 WivenLLM Documentation","isPartOf":{"@id":"https:\/\/www.wiven.ai\/#website"},"datePublished":"2026-08-19T19:10:09+00:00","dateModified":"2026-11-09T16:24:35+00:00","description":"Control WivenLLM from your applications \u2014 authentication, main entry points and OpenAI compatibility.","breadcrumb":{"@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/integrations\/api\/#breadcrumb"},"inLanguage":"en","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wiven.ai\/wiven-llm\/docs\/integrations\/api\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/integrations\/api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.wiven.ai\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/"},{"@type":"ListItem","position":3,"name":"Int\u00e9grations","item":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/integrations\/"},{"@type":"ListItem","position":4,"name":"API d\u00e9veloppeur"}]},{"@type":"WebSite","@id":"https:\/\/www.wiven.ai\/#website","url":"https:\/\/www.wiven.ai\/","name":"Wiven AI","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wiven.ai\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en"}]}},"_links":{"self":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc\/7485","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc"}],"about":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/types\/wvn_doc"}],"up":[{"embeddable":true,"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc\/7452"}],"wp:attachment":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/media?parent=7485"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}