Développeurs
Vos données de pilotage, ouvertes à vos outils et à vos agents IA
edorma expose une API REST en lecture et un serveur MCP (Model Context Protocol). Une même clé, scopée à votre établissement, ouvre les deux — créez-la dans Back-office → Intégrations → API & MCP.
API REST v1
Lecture seule, JSON, données publiées uniquement. Authentification par en-tête Authorization: Bearer edk_…
curl https://app.edorma.com/api/v1/funnel \ -H "Authorization: Bearer edk_VOTRE_CLE"
| GET /api/v1/meta | Vue d'ensemble : campagne, modules actifs, fraîcheur des données |
| GET /api/v1/funnel?year= | Photo du funnel (dernière semaine publiée) — consolidé + par campus |
| GET /api/v1/series?year= | Série hebdomadaire consolidée (tendances) |
| GET /api/v1/weeks?year= | Semaines publiées d'une campagne |
| GET /api/v1/campuses | Campus & objectifs |
| GET /api/v1/referentiel | Marques & filières |
| GET /api/v1/social | Aperçu social media (si module activé) |
| GET /api/v1/veille?tags= | Veille réglementaire formation (curatée, sourcée) |
| GET /api/v1/scolarite | Vue scolarité : effectifs par campus/régime, absences 30 j |
| GET /api/v1/planning | Occupation des salles (heures, taux) sur une fenêtre |
| GET /api/v1/lms | Assiduité e-learning : complétion par cours, actifs 30 j |
| GET /api/v1/immobilier | Parc : sites (m², €/m²/an), salles sous-utilisées, recommandations |
| GET /api/v1/insertion | Enquêtes d'insertion : taux de réponse, taux d'emploi (agrégats) |
| GET /api/v1/bpf?annee= | Agrégats BPF : produits par origine, effectifs, heures |
| GET /api/v1/messagerie | Messagerie candidats : volumes 7 j (compteurs uniquement) |
| GET /api/v1/bascule | Source de vérité par domaine : connecteur ou edorma, prérequis |
Spécification machine : /api/v1/openapi.json
Serveur MCP
Branchez Claude (ou tout client MCP) directement sur vos données : funnel, campus, veille réglementaire, benchmark marché. Transport HTTP, sans état, même clé que l'API.
claude mcp add --transport http edorma \ https://app.edorma.com/api/mcp \ --header "Authorization: Bearer edk_VOTRE_CLE"
Tools exposés : funnel hebdomadaire (photo + série), référentiel campus/marques/filières, fraîcheur des données, social media, veille réglementaire, annuaire public des établissements (SIRENE) pour le benchmark.
Bonnes pratiques
- Une clé par usage (script, tableur, agent) — révocable indépendamment.
- Les clés sont en lecture seule et ne voient que les semaines publiées.
- Ne mettez jamais une clé dans du code client (navigateur, app mobile distribuée).
Besoin d'un scope d'écriture ou d'un connecteur spécifique ? Parlons-en.