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émarrage, référence de l'API
- Contrats : le schéma JSON de chaque réponse, champ par champ
- Connecteur MCP : les mêmes opérations pour un assistant
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.