--- id: api titre: L'API de lecture type: page-du-site chemin: /api/ url: https://www.apatie.fr/api/ date: 2026-11-13 statut: redigee niveau: 1 licence: CC-BY-SA-4.0 auteur: Sébastien Vidotto (Heteractis) relecture_humaine: en attente --- # L'API de lecture > Les pages en données : arbre, nœuds, recherche, graphe, journal et vault, en fichiers statiques, en lecture seule. Tout ce que montre ce site existe aussi en **données**, par une API de lecture publique. Il n'y a pas de base de données : ce sont des fichiers JSON générés à partir des mêmes nœuds que les pages. Les pages HTML, les Markdown jumeaux, le vault, le graphe, le serveur MCP et l'avatar lisent tous ces mêmes fichiers. Chaque réponse porte la licence (CC BY-SA 4.0), l'avertissement (une réponse d'IA n'est pas une preuve), l'adresse de correction et l'adresse (`url`) de la page : citez-la. ## Les points d'entrée - [/api/index.json](/api/index.json) : la description de l'API. - [/api/arbre.json](/api/arbre.json) : l'arbre complet, avec l'identifiant, le type et le statut de chaque nœud. - `/api/noeud/{id}.json` : un nœud, avec son contenu Markdown, son parent, ses enfants, les pages reliées, les sources, les gloses et son adresse. - [/api/recherche.json](/api/recherche.json) : un index plein texte (titre, résumé, texte normalisé sans accents). - [/api/graphe.json](/api/graphe.json) : les nœuds et les liens (arbre et liens transverses), pour le [graphe](/graphe/index.md). - [/api/changements.json](/api/changements.json) : le journal des ajouts et des révisions, en ajout seulement : une ligne n'est jamais modifiée ni retirée. Une correction est une glose datée. - [/api/apatie-vault.zip](/api/apatie-vault.zip) : le vault du second cerveau (voir plus bas). - Le serveur MCP : voir [Brancher Apatie dans votre IA](/brancher/index.md). L'identifiant d'un nœud est le chemin de sa page, avec des points à la place des barres : la page `/informatique/agents-ia/rag/` a pour identifiant `informatique.agents-ia.rag`. La racine est `racine`. ## Exemples avec curl ``` curl -s https://www.apatie.fr/api/arbre.json curl -s https://www.apatie.fr/api/noeud/informatique.agents-ia.rag.json curl -s https://www.apatie.fr/api/noeud/racine.json curl -s https://www.apatie.fr/api/changements.json curl -s https://www.apatie.fr/api/recherche.json curl -s -o apatie-vault.zip https://www.apatie.fr/api/apatie-vault.zip ``` Pour chercher, on télécharge l'index `recherche.json` et on le filtre chez soi (avec jq, Python ou l'outil de votre choix) : le champ `texte` est en minuscules et sans accents. (Les adresses ci-dessus sont celles du site publié ; en préversion, remplacez-les par celle de votre aperçu.) ## Le second cerveau : le vault Les nœuds forment un **vault** téléchargeable : une note Markdown par nœud, avec un en-tête (id, type, statut, date, parent, enfants, pages reliées, sources, licence) et des liens `[[id|titre]]`. Le dossier `vault/` est navigable directement ([racine.md](/vault/racine.md)), et l'archive [apatie-vault.zip](/api/apatie-vault.zip) s'ouvre comme dossier dans Obsidian ou dans tout autre outil de notes Markdown. Licence CC BY-SA 4.0 : citez l'auteur avec le lien vers l'original (champ `url`) et diffusez toute adaptation sous la même licence. ## Les types de fiches Chaque nœud a un type, repris de la méthode des fiches liées : **concept** (une idée), **expérience et étude** (un cas, une mesure), **technique et procédé** (une façon de faire), **lieu et institution**, et **branche** (un nœud qui regroupe). Une fiche traite un seul sujet et renvoie à ses voisines, sous « À relier ». ## Ce que l'API ne fait pas - Elle n'écrit rien. Les ajouts, les gloses et les corrections acceptées passent par une API de publication signée, séparée et non publique. - Elle ne collecte aucune donnée sur vous. --- Ce site contient sûrement des erreurs : aidez-nous à les corriger. Pour proposer une correction : corrections@apatie.fr (voir /corrections/index.md). Avertissement : Une réponse d'IA n'est pas une preuve : vérifiez toujours les sources vous-même. Ne collez rien de personnel ni de sensible (identité, santé, mots de passe, données de clients ou de tiers). Vous restez responsable de ce que vous faites des réponses. Avant d'utiliser ce texte avec une IA : https://www.apatie.fr/avant-d-utiliser-nos-prompts/ Citation : « L'API de lecture », Sébastien Vidotto (Heteractis), https://www.apatie.fr/api/, licence CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/deed.fr). Modifications : aucune.