Développer · Démarrage
Premier appel à l'API
L'API REPERES ouvre à votre code ce que le connecteur MCP ouvre à un assistant : contexte documentaire sourcé, information ponctuelle vérifiée, valeurs de référence datées, simulateurs et réponses rédigées. Mêmes droits, même clé, même comptage.
1. Un compte et une clé
Un compte REPERES identifié suffit : organisme gestionnaire, abonnement individuel ou accès développeur (API et connecteur dans la franchise mensuelle, sans l'assistant de l'application). La clé se crée sur la page de connexion MCP, rubrique « Clés API » : rpr_sk_…, affichée une seule fois, à conserver comme un mot de passe.
export REPERES_API_KEY=rpr_sk_…2. Un premier appel
Base : https://mcp.reperes.bmse.fr. Chaque requête porte l'en-tête Authorization: Bearer. Une valeur de référence, datée et sourcée :
curl -s "https://mcp.reperes.bmse.fr/api/v1/valeurs/smic.horaire?date=2026-03-01" \
-H "Authorization: Bearer $REPERES_API_KEY"La réponse suit le contrat etalon.result.v1 : statut, valeur en décimal exact, date d'effet, source primaire et passage cité. Le contexte documentaire d'une question professionnelle, que votre code ou votre modèle exploite pour rédiger :
curl -s "https://mcp.reperes.bmse.fr/api/v1/context" \
-H "Authorization: Bearer $REPERES_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "Quels repères pour construire un projet de service ?"}'Une simulation, par exemple la rémunération d'un éducateur spécialisé en CCN 66 :
curl -s "https://mcp.reperes.bmse.fr/api/v1/calcul/remuneration" \
-H "Authorization: Bearer $REPERES_API_KEY" \
-H "Content-Type: application/json" \
-d '{"convention": "ccn66", "emploi": "educateur_specialise", "anciennete_ans": 10, "type_etablissement": "mecs"}'3. Franchise et crédits
Par mois civil, un compte dispose de 1 000 lectures de valeurs et calculs et de 200 opérations de contexte et de précision ; l'option Génération ouvre 150 réponses rédigées. Au-delà, l'opération est payée en crédits prépayés, débités après livraison : une opération en échec n'est jamais décomptée. Une opération payée renvoie X-Reperes-Credits-Charged et X-Reperes-Credits-Remaining ; chaque opération comptée renvoie X-Reperes-Operation-Id, à communiquer au support. Barème et packs : tarifs.
4. Codes d'erreur
Une erreur rend un objet {"error": "…"}, avec detail quand il aide à corriger l'appel. Un statut métier (not_found, depends, contexte vide) n'est pas une erreur : il arrive avec un code 200.
- 400
- Corps ou paramètre invalide ;
detaildit lequel. - 401
- Clé absente, invalide ou révoquée.
- 402
- Franchise du mois atteinte et crédits insuffisants (
credits_exhausted,credits_required,credits_balance,upgrade_url). - 403
- Opération hors du droit du compte (
upgrade_url). - 413
- Corps supérieur à 16 Ko.
- 422
- Simulation non couverte (convention, emploi, date) : le résultat dit pourquoi ; non comptée.
- 429
- Débit dépassé : attendre
Retry-Aftersecondes. - 502
- Moteur indisponible ; l'opération n'est pas comptée.
Pour la suite
- Référence de l'API : chaque route, ses paramètres, son corps et ses réponses.
- Contrats : le schéma de chaque réponse versionnée, champ par champ.
- Connecteur MCP : les outils proposés aux assistants et leurs paramètres.