reperes.bmse.fr/docs
Documentation technique
Cette documentation décrit ce que REPERES expose aux intégrateurs : l'API, le connecteur MCP, les données, la forme de leurs réponses et les règles pour les lire. Elle s'adresse aux développeurs, aux éditeurs de logiciels et aux équipes qui relient REPERES à leurs outils.
Développer
Démarrage
Compte, clé API, premier appel, franchise mensuelle et crédits, codes d'erreur.
Référence de l'API
Chaque route : paramètres, corps de requête, réponses ; tirée de l'OpenAPI publié.
Contrats
Le schéma JSON de chaque réponse versionnée, champ par champ, et les règles de version.
Connecteur MCP
Adresse, authentification, droits et outils proposés aux assistants, avec leurs paramètres.
SDK Python
Le paquet reperes : client sans dépendance, résultats et crédits, erreurs typées.
CLI
La commande reperes : contexte, valeurs et simulateurs en ligne de commande, sortie JSON.
Données
corpus.inventaire.v1
Corpus documentaire
Ce que REPERES consulte, domaine par domaine : code de l'action sociale et des familles, conventions collectives, jurisprudence, rapports, veille, statistiques publiques ; et la doctrine, l'expertise BMSE.
etalon.catalogue.v1
Valeurs de référence
SMIC, minima sociaux, plafonds de l'APA et de la PCH, taux de cotisation, indices : chaque valeur nationale en vigueur, sa date d'effet, son identifiant et le texte qui l'établit.
Conventions communes
Elles valent pour toutes les réponses de valeurs.
- Montants et taux
- Décimal exact transmis en chaîne (
"1867.02"), jamais en nombre flottant ; aucune valeur n'est arrondie au passage. - Dates
- Format ISO
AAAA-MM-JJ, comparables telles quelles. - Période de validité
valide_duinclus,valide_auexclu : c'est le début de la valeur suivante ou la fin déclarée par le texte, absente tant que la valeur court.- Absence
- Une période non renseignée rend
not_found. Une valeur n'est jamais extrapolée d'une période voisine. - Source
- Chaque valeur porte sa source primaire et le passage cité mot pour mot ; une valeur calculée porte ses opérandes (par exemple le SMIC mensuel, calculé à partir du SMIC horaire).
- Version
- Chaque réponse déclare son contrat dans
schema_version(etalon.result.v1,etalon.catalogue.v1). Un contrat inconnu ne doit pas être interprété.
Accès aux valeurs
Un même contrat, servi par chaque canal. L'identifiant d'un paramètre (smic.horaire) est celui du catalogue.
| Canal | Lecture | Accès |
|---|---|---|
| Pages publiques | /valeurs/{id} : valeur en vigueur et historique ; /docs/valeurs : catalogue | Libre |
| API | GET /api/v1/valeurs/{id}?date=…, /historique, ?q=… (recherche) | Clé API |
| MCP | Outil reperes_valeur | Compte REPERES |
| CLI | reperes valeur smic.horaire | Clé API |