Développer · Contrats
Contrats de réponse
Chaque réponse de REPERES suit un contrat versionné. Son schéma JSON est généré depuis le code qui la produit : la documentation ne peut pas s'en écarter, et les cas de référence des simulateurs sont validés contre lui à chaque version.
Contrats publiés
etalon.result.v1
Valeur de référence
Lecture d'Étalon : valeur applicable à une date, un territoire et des coordonnées, avec sa source, sa date d'effet et sa fraîcheur ; historique, recherche ou résolution d'une question selon le mode.
etalon.catalogue.v1
Catalogue des valeurs
Catalogue public des paramètres d'Étalon : valeurs nationales en vigueur de source publique, historique et fraîcheur.
calcul.remuneration.v1
Simulation de rémunération
Rémunération conventionnelle CCN 66 ou CCN 51 : brut, net, coût employeur, chaque ligne sourcée ; questions à poser et signalements.
calcul.esat.v1
Rémunération garantie en ESAT
Rémunération garantie d'un travailleur d'ESAT : part de l'ESAT, aide au poste, bornes, cotisations et coût pour l'ESAT.
calcul.trajectoire.v1
Trajectoire d'une rémunération
Brut conventionnel d'un emploi CCN 66 ou CCN 51 année par année, en euros courants et constants, et effets du point, de la grille, de l'ancienneté et des mesures nationales.
calcul.autonomie.v1
APA à domicile
Démonstrateur APA à domicile : plafond, participation et reste à charge d'un mois, chaque ligne sourcée ; informations manquantes et contrôles.
Règles de version
- Version déclarée
- Chaque réponse porte son contrat dans
schema_version. Un contrat inconnu ne doit pas être interprété. - Évolution compatible
- Un champ peut être ajouté sans changer de version : un client ignore les champs qu'il ne connaît pas.
- Rupture
- Renommer, retirer ou changer le sens d'un champ crée une nouvelle version (
v2) ; l'ancienne reste servie le temps de la transition. - Montants
- Décimal exact transmis en texte (
"1867.02"), jamais en nombre flottant ; à convertir avec un type décimal. - Statut
- Une valeur de référence porte
status(ok,depends,ambiguous,not_found,revalorisation_attendue,technical_error) ; une simulation portestatut(ok,partiel,erreur). Les valeurs d'Étalon utilisées par un calcul sont toujours dansvaleurs. - Absence
- Un champ facultatif absent ou
nulln'est jamais remplacé par une valeur par défaut : le statut et le message disent pourquoi.