API de gestion scolaire pour développeurs Tout ce que fait Edena, depuis votre code

Plus de 800 opérations, un événement pour chaque changement, une CLI pour vous et votre agent IA, et un connecteur pour Claude et ChatGPT. Chaque clé agit avec un rôle de l'établissement et accède exactement à ce qu'une personne ayant ce rôle peut atteindre.

Installer la CLI
$ npm install -g @edena-solutions/cli

30 jours d'essai, sans carte bancaire.

Votre établissement utilise déjà Edena ? La console se trouve dans Développeurs, dans le menu de l'application.

edena login · Autoriser la CLI d'Edena · Sandbox · edena students list · edena skill install

Quatre façons de construire sur Edena

La même API est sous chacune d'elles. Appelez-la depuis votre serveur, recevez chaque changement à l'instant, travaillez depuis le terminal ou laissez votre application parler au nom de chaque famille.

API REST

Élèves, factures, présences, CRM, emplois du temps : chaque écran d'Edena a son opération. Envoyez la clé dans l'en-tête Authorization et recevez du JSON, typé dans la référence OpenAPI.

Prête pour la production dès la première requête

Ce que vous attendez d'une API sérieuse, avec son comportement écrit dans la référence.

Des relances sans doublons

Envoyez chaque écriture avec Idempotency-Key et répétez-la pendant 24 heures : elle répond comme la première fois et ne s'exécute pas deux fois.

› Idempotency-Key: 5f0c2e9a-…

Des erreurs avec une clé stable

Toutes les erreurs répondent avec le même corps. Décidez avec key, qui ne change pas, et gardez le requestId. Plus de 400 clés sont documentées.

› "key": "auth.api_key_in_browser"

Des limites lisibles

300 requêtes par minute par clé et 1 200 pour toutes les clés de l'organisation. Chaque réponse indique la marge restante ; au-delà, 429 avec Retry-After.

› X-RateLimit-Remaining: 287

Une référence OpenAPI publique

Chaque opération avec ce qu'elle reçoit, ce qu'elle renvoie et ses erreurs, en anglais, espagnol et catalan. La CLI et les agents la lisent pour ne rien inventer.

› GET /openapi.json?lang=en

Une vraie sandbox

Une copie vide de votre établissement avec ses propres clés. Rien n'en sort : ni e-mails, ni notifications, ni VeriFactu en production, ni paiements par carte.

› edn_test_…

Vous décidez qui écrit aux familles

Si votre application parle aux familles, coupez les e-mails et notifications d'Edena qui leur sont destinés. Le personnel et l'équipe de développement continuent de recevoir les leurs.

› 409 organization.family_messaging_off

Chaque requête, avec sa trace

La console garde 30 jours de requêtes avec leur requestId, la latence p95 et chaque livraison de webhook avec la réponse de votre système.

› X-Request-Id: 0190f4d2-…

Un prompt par catégorie

Copiez le prompt d'une catégorie depuis la documentation ou lancez edena prompt : votre agent implémente l'intégration avec les types exacts.

› edena prompt invoices

Connecteur MCP Edena dans Claude et ChatGPT

Chaque membre de l'équipe connecte son assistant avec son propre compte et pose ses questions sur l'établissement dans sa langue. L'assistant voit et fait ce que cette personne peut faire dans Edena, jamais plus.

Fonctionne dans
  • Claude
  • ChatGPT
  • Claude Code
  • Codex
  • Gemini CLI
  • GitHub Copilot
  • Cursor
  • Tout client MCP distant
  1. Combien d'élèves de CE2 B étaient absents hier ?
  2. Hier, 2 des 24 élèves de CE2 B étaient absents. La famille a déjà justifié l'une des absences depuis l'application.
  3. Convoque leurs familles à une réunion jeudi à 17 h.
  4. C'est fait. La réunion est dans le calendrier de CE2 B.

Connecté en une minute

  1. 1

    Ajoutez l'adresse

    Dans votre assistant, comme connecteur personnalisé. Dans Claude, c'est dans Paramètres, Connecteurs.

  2. 2

    Approuvez l'accès dans Edena

    Vous choisissez l'établissement et si l'assistant consulte seulement ou peut aussi faire des changements.

  3. 3

    Demandez dans votre langue

    Il trouve l'opération, l'exécute en votre nom et résume la réponse. Avant chaque changement, il vous demande confirmation.

Six outils

Ceux qui modifient des données n'apparaissent que si la personne l'a permis en le connectant.

  • whoami Consultation Au nom de qui il agit : personne, établissement, rôles et droit de modifier.
  • search_operations Consultation Cherche les opérations de l'API avec des mots simples.
  • describe_operation Consultation Décrit une opération avec ses paramètres et ses types.
  • read_operation Consultation Fait une consultation au nom de la personne.
  • prepare_change Changement Prépare un changement sans le faire et montre ce qu'il fera.
  • apply_change Changement Fait le changement confirmé, une seule fois.

Ce qu'un assistant ne fait jamais

Même si la personne peut le faire dans Edena.

  • Factures et argent, seulement dans Edena

    Émettre ou annuler des factures, encaissements, remboursements, porte-monnaie et prélèvements se font toujours dans Edena.

  • Ni permissions ni réglages

    Qui peut faire quoi, l'équipe et les réglages de l'établissement ne se changent pas depuis un assistant.

  • Données sensibles, masquées

    Coordonnées bancaires, pièces d'identité, données de santé et identifiants lui arrivent masqués.

  • L'établissement décide

    Un administrateur choisit quels rôles peuvent connecter un assistant et peut tous les déconnecter à l'instant.

Jusqu'à 120 appels par minute par personne et 1 200 par établissement. Ce que l'assistant lit est traité par son fournisseur, avec le compte de la personne.

Et Ena ? Ena est l'IA qui vit déjà dans Edena, sur le web et dans l'application. Le connecteur s'adresse à qui préfère travailler depuis son propre assistant. Découvrir Ena

Comment votre équipe de développement arrive

Qui développe avec vous a son propre compte et sa console, sans voir les données de l'établissement. En quatre étapes, il fait sa première requête.

Invitez qui développe

Dans Développeurs, Équipe. Un administrateur de développement crée des clés et invite ; un développeur consulte la documentation, les requêtes et la consommation. Les administrateurs de l'établissement font déjà partie de l'équipe.

Besoin de l'API seulement ?

Créez une organisation de développement

Tous les modules par API pour votre propre logiciel, avec la console, la sandbox et les clés, sans la suite de gestion. 30 jours d'essai, sans carte.

Créer un compte développeur

Questions fréquentes des développeurs

Ce que demande souvent qui intègre Edena pour la première fois.

Que peut faire une clé d'API ?
Elle agit avec le rôle avec lequel elle a été créée, administrateur ou gestionnaire (avec son sous-rôle, s'il y en a un), et accède exactement à ce qu'atteint une personne ayant ce rôle. S'il lui manque une permission, l'API répond 403. Une organisation peut avoir jusqu'à 25 clés actives, et chacune se révoque en quelques secondes depuis la console.
Mon établissement doit-il utiliser Edena pour utiliser l'API ?
Non. Si votre établissement utilise déjà Edena, la console se trouve dans Développeurs, dans le menu de l'application. Si vous voulez seulement l'API pour votre propre logiciel, créez une organisation de développement : elle a tous les modules par API, la console et la sandbox, avec 30 jours d'essai sans carte.
Puis-je tester sans toucher aux données réelles ?
Oui. Depuis Environnement, vous créez une sandbox : une copie vide de votre établissement avec ses propres clés (edn_test_). Aucun e-mail ni notification n'en part vers les familles, rien n'est envoyé à VeriFactu en production et aucune carte n'est débitée. Vous pouvez la réinitialiser quand vous voulez.
Comment mon système apprend-il les changements ?
Par webhooks : chaque changement dans Edena (une inscription, une facture encaissée, une présence) arrive à votre endpoint sous forme de POST signé en HMAC-SHA256, et il est relancé pendant environ trois jours s'il ne répond pas. GET /webhook-events liste les événements des 30 derniers jours, et en local edena listen vous les transmet sans adresse publique.
Mon application peut-elle agir au nom de chaque famille ?
Oui, avec des jetons d'utilisateur final. Votre serveur les demande avec une clé administrateur et les remet à l'application, qui accède à ce que cette famille voit dans les applications d'Edena : ses enfants, ses factures, ses communiqués et son calendrier. Si la famille n'a pas de compte Edena, un compte est créé pour votre seule application. Une clé envoyée depuis un navigateur reçoit un 403.
Que fait le connecteur pour Claude et ChatGPT ?
Il permet à chaque membre de l'équipe d'utiliser Edena depuis son assistant IA, avec son compte et ses permissions. Il consulte ce que la personne peut voir et, si elle l'autorise, prépare des changements qui ne se font qu'après sa confirmation. Il n'émet jamais de factures, ne déplace pas d'argent, ne change ni permissions ni réglages, et ne reçoit aucune donnée bancaire, d'identité ou de santé.
Quelle différence entre Ena et le connecteur ?
Ena est l'IA d'Edena : elle vit dans le web et dans l'application, avec le contexte de l'établissement. Le connecteur amène Edena dans l'assistant que chaque personne utilise déjà, comme Claude ou ChatGPT. Dans les deux cas, les permissions de chacun s'appliquent et les changements sont confirmés avant d'être faits.
Qui peut entrer dans la console développeurs ?
Les administrateurs de l'établissement et les personnes que vous invitez dans l'équipe de développement, comme administrateur de développement ou comme développeur. Qui n'est que développeur entre dans la console, jamais dans les données de l'établissement.
Quelles limites a l'API ?
300 requêtes par minute par clé et 1 200 pour toutes les clés de l'organisation. Avec des jetons d'utilisateur final, 300 par personne et 6 000 pour toutes les personnes de l'application. Chaque réponse indique la marge restante, et au-delà l'API répond 429 avec Retry-After.

Le secrétariat clôture le mois sans courir après les familles

Les factures partent avec Verifactu, les présences sont enregistrées et chaque famille le voit dans l'appli. Le voir avec un établissement comme le vôtre prend 15 minutes.

Parlons-en