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 : la description de l'API.
- /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 : un index plein texte (titre, résumé, texte normalisé sans accents).
- /api/graphe.json : les nœuds et les liens (arbre et liens transverses), pour le graphe.
- /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 : le vault du second cerveau (voir plus bas).
- Le serveur MCP : voir Brancher Apatie dans votre IA.
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.zipPour 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), et l'archive 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.