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 :

Valeur du SMIC horaire au 1er mars 2026
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 :

Contexte sourcé d'une question
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 ; detail dit 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-After secondes.
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.