Construire dessus
Le socle, ouvert en lecture
Foundation est la seule surface de l'écosystème sans donnée client. C'est ce qui permet de l'ouvrir sans risque, et c'est un avantage dont il faut se servir. Aucune clé à demander, aucune inscription, aucune route réservée.
Deux régimes
L'accès, immédiat, sans inscription et sans rien demander.
Un quota plus large, la mesure d'usage, et un contact pour prévenir avant une évolution d'interface.
Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After sont servis dans les deux régimes : un quota qui ne se lit pas est un quota qui surprend.
- Aucune route n'est réservée aux porteurs d'une clé.
- Aucune donnée servie sans clé n'est plus ancienne que celle servie avec.
Ce qui n'est jamais servi
- Aucune donnée d'entreprise, aucune ligne individuelle, aucun brouillon.
- Aucune session de visite, aucun identifiant de personne, aucune adresse.
- Aucun agrégat qui ne soit pas déjà publié sur le site sous le seuil d'anonymat.
- Aucun effectif exact de segment : ce qui sort est la tranche.
- Aucune écriture : l'interface est en lecture seule, sans exception.
Les routes
Cette liste vient de la spécification servie par le code. Ce qui n'y figure pas n'est pas servi.
| Route | Ce qu'elle rend |
|---|---|
| GET /api/public/v1/specification | La spécification de cette interface, produite par le code qui la sert. Version, routes, régimes d'accès, licence, contact, et ce qui n'est jamais servi. |
| GET /api/public/v1/vocabulaire | Le vocabulaire ouvert : espaces de noms, identifiants, politique de stabilité. Les identifiants publiés avec leur libellé, leur ancre de sens et leur statut. |
| GET /api/public/v1/vocabulaire/{espace} | Les identifiants d'un espace de noms. La liste des identifiants de l'espace, actifs et dépréciés. |
| GET /api/public/v1/concepts | Le dictionnaire public, en liste. Code, dénomination, famille, définition simple et adresse de page. |
| GET /api/public/v1/concepts/{code} | Un concept et ses quatre niveaux de lecture. Définitions, intérêt pour une PME, exemple, données nécessaires et sources. |
| GET /api/public/v1/donnees | Les fiches de donnée du standard volontaire, en liste. Clé, dénomination courante, unité, période et détenteur habituel. |
| GET /api/public/v1/donnees/{slug} | Une fiche de donnée et les cadres qui la demandent. Définition, période, documents, détenteur, et la définition retenue par cadre. |
| GET /api/public/v1/referentiels | Les référentiels instruits par la carte des correspondances. Code, dénomination et nombre d'exigences instruites. |
| GET /api/public/v1/referentiels/{code} | Les exigences d'un référentiel. Code local, intitulé, résumé, unité et période de chaque exigence. |
| GET /api/public/v1/correspondances | La carte des correspondances entre référentiels. Chaque lien avec sa NATURE déclarée et la raison écrite qui la justifie. |
| GET /api/public/v1/regles | Les règles réglementaires publiées. Énoncé, horizon, nature d'affirmation, niveau, sources et millésime courant. |
| GET /api/public/v1/millesimes | Les millésimes publiés du jeu de règles. Code, date, note de version et empreinte du jeu. |
| GET /api/public/v1/ressources | Le catalogue des ressources publiées. Titre, résumé, format, public visé et adresse de fiche. |
| GET /api/public/v1/statistiques | Les statistiques déjà publiées par l'observatoire, période par période. Métriques publiées, avec la tranche d'effectif du segment et la nature du dénominateur. |
| POST /api/public/v1/mcp | Le canal machine : cinq outils, des réponses structurées et sourcées. Une réponse JSON-RPC 2.0 conforme au protocole des serveurs de contexte. |
| GET /api/public/v1/statistiques/{dimension}/{cle} | Les statistiques publiées d'un segment. Les mêmes métriques, pour un segment déjà publié. 404 sous le seuil. |
Le canal machine
Un assistant à qui l'on demande si la CSRD concerne une PME de trente personnes répond aujourd'hui de mémoire. Sur un seuil réglementaire, une réponse de mémoire est fausse une fois sur trois, et personne ne la conteste avant d'avoir payé un conseil pour la vérifier. Ce canal lui donne la réponse sourcée.
/api/public/v1/mcp- obligations_du_profilQuelles obligations concernent un profil, avec leur source et leur millésime.
- expliquer_un_conceptUne définition à quatre niveaux de lecture, avec ses textes dates.
- decrire_une_donneeCe qu est une donnée, où la trouver, et ce que chaque cadre en retient.
- correspondances_entre_referentielsCe qui se recoupe entre deux cadres, avec la nature déclarée du lien.
- statistique_publieeUne statistique déjà publiée, avec la nature de son dénominateur.
Cinq outils au plus, et aucun n'agit : un canal machine se juge sur la qualité de quelques outils bien nommes, jamais sur leur nombre. Chaque réponse est structurée et porte ses sources.
Avant d'écrire une ligne
Lisez le vocabulaire ouvert : les identifiants que vous écrirez dans votre code portent une politique de stabilité, et nous nous engageons dessus. Et lisez les conditions de réutilisation, elles tiennent en deux régimes.
Source : STRATA Foundation, ESG Observatory, jeu api, période toutes périodes. /api/public/v1