Skip to main content

REPERES — kit de développement

SDK Python et CLI de l'API REPERES, l'outil d'expertise du champ social et médico-social de BMSE : contexte documentaire sourcé, information ponctuelle vérifiée, valeurs de référence datées et sourcées, simulateurs (rémunération conventionnelle CCN 66 et CCN 51, ESAT, trajectoire en euros constants, APA à domicile) et réponses rédigées.

Python 3.10 ou plus, aucune dépendance. Licence Apache 2.0.

pip install reperes
export REPERES_API_KEY=rpr_sk_…

La clé se crée sur la page de connexion MCP de REPERES, rubrique « Clés API » ; un compte identifié suffit, l'usage est gratuit dans la franchise mensuelle (tarifs).

SDK

from reperes import Reperes, CreditsEpuises

client = Reperes()  # clé lue dans REPERES_API_KEY

smic = client.valeur("smic.horaire", date="2026-03-01")
print(smic["valeurs"][0]["valeur"], smic["valeurs"][0]["source"]["titre"])

plafond = client.valeur("apa.domicile.plafond", coordonnees={"gir": 1})

contexte = client.context("Quels repères pour construire un projet de service ?")
for s in contexte["sources"]:
    print(s["title"], s["url"])

simulation = client.remuneration({
    "convention": "ccn66",
    "emploi": "educateur_specialise",
    "anciennete_ans": 10,
    "type_etablissement": "mecs",
})
print(simulation["statut"], simulation.operation_id)

Chaque méthode rend un Resultat : le JSON de la réponse, au contrat déclaré dans schema_version, avec operation_id (à communiquer au support) et, quand l'opération dépasse la franchise, credits_debites et credits_restants.

Méthode Route Contrat
context(question, exploration=False) POST /api/v1/context contexte sourcé
precision(question) POST /api/v1/precision information ponctuelle
answer(question) POST /api/v1/answer réponse rédigée
valeur(id, date=, territoire=, coordonnees=) GET /api/v1/valeurs/{id} etalon.result.v1
historique(id), resoudre(question), rechercher(q, famille=) GET /api/v1/valeurs… etalon.result.v1
remuneration(profil), modeles() /api/v1/calcul/remuneration, /modeles calcul.remuneration.v1
trajectoire(demande) POST /api/v1/calcul/trajectoire calcul.trajectoire.v1
esat(demande) POST /api/v1/calcul/esat calcul.esat.v1
autonomie(scenario) POST /api/v1/calcul/autonomie calcul.autonomie.v1
source(id, contenu=False), contrats(), schema(nom), openapi() publics

Une simulation non couverte (emploi inconnu, date hors période) rend son résultat avec statut: "erreur" et statut_http == 422. Les autres échecs lèvent une erreur typée, sans jamais la clé ni le texte de la question :

Erreur Cas
ErreurConfiguration clé absente ou invalide, adresse invalide : rien n'est envoyé
ErreurRequete corps ou paramètre refusé (detail dit lequel)
ErreurAuthentification clé invalide ou révoquée (401)
ErreurDroit opération hors du droit du compte (403, upgrade_url)
CreditsEpuises franchise du mois atteinte, crédits insuffisants (402, credits_requis, solde)
DebitDepasse débit dépassé après les nouvelles tentatives (429, attente)
ServiceIndisponible API injoignable ou moteur indisponible (non compté)

Toutes dérivent de ErreurReperes. Un débit dépassé est retenté deux fois par défaut, en respectant Retry-After (Reperes(tentatives=0) pour s'en passer).

CLI

reperes context "Quels repères pour construire un projet de service ?" --exploration
reperes precision "Quelle est la durée maximale d'un CPOM ?"
reperes valeur smic.horaire --date 2026-03-01
reperes valeur apa.domicile.plafond --coord gir=1
reperes valeur "plafond APA GIR 1"
reperes valeur point.ccn66 --historique
reperes remuneration ccn66 educateur_specialise --anciennete 10 --etablissement mecs --oui surclassement_internat
reperes remuneration --modeles
reperes trajectoire ccn66 moniteur_educateur --etablissement ime --lecture carriere --debut 2016
reperes esat --part 35 --effectif 30
reperes autonomie scenario.json --prix 32
reperes contrats
printf '%s' 'Ma question' | reperes context -

Le JSON reçu sort sur stdout (--pretty pour l'indenter) ; les erreurs sur stderr, avec le code HTTP et le code d'erreur de l'API. Codes de sortie : 0 succès, y compris un statut métier (not_found, contexte vide) ; 1 erreur HTTP ou réseau, clé absente, ou livraison dégradée (recherche indisponible, statut d'erreur) ; 2 arguments invalides. Options communes : --base-url (sinon REPERES_API_URL), --timeout (180 secondes).

Documentation

Développement

PYTHONPATH=src:tests python -m unittest discover -s tests -t tests

Metadata

Release files for reperes 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reperes 0.1.0
File Size Uploaded Provenance Actions
reperes-0.1.0.tar.gz 23.1 kB With provenance Details for reperes-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for reperes 0.1.0
File Interpreter ABI Platform Actions
reperes-0.1.0-py3-none-any.whl Python 3 none any Details for reperes-0.1.0-py3-none-any.whl

Total release size: 44.1 kB

Release files / reperes-0.1.0.tar.gz

Download URL reperes-0.1.0.tar.gz
Size 23.1 kB
Tags Source
SHA-256 checksum
How to use checksums
ac3b08b8811f8174d8f5cfc996b620f00fead1bd68f8ef2ba0b667eeae58c65e
BLAKE2b-256 checksum
How to use checksums
78916529fcef5120de9c64bb43812a0fe83705088eb33d44b40eb217cd174dc5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / reperes-0.1.0-py3-none-any.whl

Download URL reperes-0.1.0-py3-none-any.whl
Size 21.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4645f8a60634435870cb67002617f41e299fb6ac8a2f0dcd89c6b2540b1017d7
BLAKE2b-256 checksum
How to use checksums
71a32cb3d1fa5c32e69cf350d25065aff54276c46e3dd6a50da29cc2ce6e8543
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for reperes 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for reperes-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page