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

Données

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_du inclus, valide_au exclu : 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.

CanalLectureAccès
Pages publiques/valeurs/{id} : valeur en vigueur et historique ; /docs/valeurs : catalogueLibre
APIGET /api/v1/valeurs/{id}?date=…, /historique, ?q=… (recherche)Clé API
MCPOutil reperes_valeurCompte REPERES
CLIreperes valeur smic.horaireClé API