Blog

API et webhooks dans le logiciel scolaire : relier la gestion de l'établissement à votre site, votre application et votre comptabilité

Ce que sont une API et un webhook, dix intégrations utiles dans une école ou une académie et ce qu'il faut exiger de l'API de votre logiciel de gestion.

Ena by Edena | 8 min de lecture
API et webhooks dans le logiciel scolaire : relier la gestion de l'établissement à votre site, votre application et votre comptabilité

Dans presque tous les établissements, quelqu'un recopie des données d'un endroit à un autre : les demandes du formulaire du site dans le logiciel d'admissions, les nouveaux élèves dans la plateforme d'apprentissage, les factures dans le tableur envoyé au comptable, les absences dans un rapport pour la direction. Ce travail existe parce que les logiciels ne se parlent pas. Ce qui les fait parler s'appelle une API, et son complément, ce sont les webhooks.

Cet article explique ce qu'ils sont, avec des exemples tirés d'une école, d'une crèche ou d'une académie ; dix intégrations qui font vraiment gagner du temps ; comment se construit une intégration étape par étape ; et ce que devrait offrir l'API de votre logiciel de gestion avant que quiconque écrive la première ligne de code.

Ce qu'est une API

Une API est un ensemble d'opérations qu'un logiciel propose à d'autres : « donne-moi la liste des élèves de CE1 B », « crée cette demande d'inscription », « marque cette facture comme payée ». Celui qui l'utilise envoie une requête avec une clé qui l'identifie et reçoit une réponse contenant les données, en général au format JSON.

Trois idées pour la comprendre sans jargon :

  • Elle fait la même chose que les écrans, mais depuis un autre logiciel. Si vous pouvez inscrire un élève dans le logiciel de gestion, votre site ou votre système peuvent aussi le faire via l'API.
  • Chaque clé a des permissions. Une clé créée avec le rôle de gestionnaire accède exactement à ce qu'une personne ayant ce rôle peut atteindre, ni plus ni moins.
  • Elle est documentée. Une API sérieuse publie ses opérations, les données que chacune reçoit, ce qu'elle renvoie et les erreurs possibles.

Ce qu'est un webhook

Un webhook, c'est le chemin inverse : au lieu que votre système pose la question, le logiciel de gestion prévient. Quand quelque chose se produit (une nouvelle inscription, une facture payée, un appel avec des absents), il envoie un message à l'adresse que vous avez indiquée, avec le détail du changement.

Trois éléments distinguent un webhook fiable :

  • Il est signé, pour que votre système vérifie que l'avis vient bien du logiciel de gestion.
  • Il est renvoyé si votre système ne répond pas, pendant des heures ou des jours, pour ne perdre aucun événement.
  • Il peut être consulté ensuite, au cas où votre système aurait été indisponible et où vous devriez récupérer ce qui s'est passé.

Dix intégrations utiles dans un établissement

  1. Du formulaire du site aux admissions. Chaque demande du formulaire entre dans le CRM des admissions avec son origine, sans rien recopier.
  2. De l'inscription confirmée à la plateforme d'apprentissage. Quand un élève s'inscrit, un webhook prévient votre système, qui crée son compte sur la plateforme d'apprentissage que vous utilisez.
  3. Des factures payées à la comptabilité. Chaque encaissement arrive dans votre logiciel comptable ou chez votre comptable avec sa facture, comme nous l'expliquons dans l'article sur l'intégration avec le cabinet comptable.
  4. Des présences vers un tableau de bord de direction. Les données de présence de chaque jour alimentent votre propre tableau de bord dans l'outil d'analyse de l'établissement.
  5. Des absences du jour vers la cantine ou le transport. Qui n'est pas venu aujourd'hui, pour ajuster les repas ou les circuits.
  6. Votre propre application pour les familles. Avec des jetons d'utilisateur final, votre application montre à chaque famille ses enfants, ses factures et ses annonces, et rien d'autre.
  7. Calendrier et activités sur le site public. Les événements et les activités périscolaires avec des places disponibles se publient seuls sur le site de l'établissement.
  8. Un tableau de bord consolidé pour un groupe d'établissements. Si chaque établissement a son propre compte, l'équipe du groupe peut lire les données de chacun avec sa clé et construire son propre rapport pour tout le réseau.
  9. Des données pour le système académique. Préparer, dans le format demandé par votre système académique, les données déjà présentes dans la gestion, sans les ressaisir.
  10. Des alertes pour l'équipe dans son outil de travail. Une nouvelle demande d'inscription ou un prélèvement rejeté apparaît dans le canal que l'équipe utilise déjà.

Inutile de tout faire. Commencez par celle qui oblige aujourd'hui quelqu'un à recopier des données chaque semaine.

Construire une intégration, étape par étape

  1. Définissez l'objectif. Quelle donnée va d'où à où, à quelle fréquence et qui en a besoin.
  2. Travaillez dans un environnement de test. Un bac à sable est une copie vide de l'établissement où l'on peut tester sans toucher aux données réelles ni rien envoyer aux familles.
  3. Créez une clé avec le rôle minimum. Si l'intégration ne fait que lire les présences, elle n'a pas besoin de pouvoir émettre des factures.
  4. Programmez les appels et les webhooks en suivant la documentation, et gérez les erreurs et les renvois.
  5. Testez avec des cas réels : un élève avec deux familles, un prélèvement rejeté, un départ en cours d'année.
  6. Passez en production avec une nouvelle clé pour les données réelles, stockée sur le serveur.
  7. Surveillez le journal des requêtes et des livraisons de webhooks pendant les premières semaines.

Ce qu'il faut exiger de l'API de votre logiciel de gestion

Avant de commander une intégration, vérifiez que l'API du fournisseur remplit ces points :

  • Une documentation publique et complète, idéalement au format OpenAPI, avec ce que chaque opération reçoit et renvoie.
  • La couverture de tous les modules, pas seulement des élèves et des familles. Si quelque chose se fait à l'écran mais pas par l'API, tôt ou tard vous devrez le recopier à la main.
  • Des webhooks pour les changements importants, signés et avec renvois.
  • Un environnement de test d'où rien ne sort vers le monde réel.
  • Des clés par rôle, révocables immédiatement et avec une limite de clés actives.
  • Des limites de requêtes documentées, avec des en-têtes qui indiquent la marge restante.
  • Des erreurs avec une clé stable, pour que votre code sache quoi faire dans chaque cas.
  • Des renvois sûrs : pouvoir répéter une écriture sans qu'elle soit exécutée deux fois.
  • Un journal des requêtes qui permette de savoir ce qui s'est passé et quand.
  • Des jetons pour les applications tierces qui agissent comme une famille précise sans exposer la clé de l'établissement.

Une telle API est aussi votre garantie de portabilité : si vous changez un jour de fournisseur, vous pourrez sortir vos données proprement. Nous l'expliquons dans l'article sur l'interopérabilité et la portabilité.

Sécurité et protection des données

  • La clé ne va jamais dans le navigateur ni dans l'application. Elle reste sur le serveur ; l'application utilise des jetons d'utilisateur final.
  • Le rôle minimum pour chaque intégration, et une clé différente pour chacune, afin de pouvoir la révoquer sans toucher aux autres.
  • Un contrat de sous-traitance avec l'agence ou le développeur qui travaille avec des données réelles.
  • Des données de test dans le bac à sable, jamais des copies des données réelles d'élèves.
  • Une revue régulière des clés actives et des personnes ayant accès à la console de développement.

Programmer avec l'IA sur l'API de l'établissement

Les agents de programmation comme Claude Code, Codex ou Gemini CLI ont changé qui peut construire une intégration. Si l'API a une référence publique, l'agent la lit, comprend quelles opérations existent et écrit le code. Pour que cela se passe bien :

  • Travaillez toujours dans le bac à sable, avec des clés de test.
  • Donnez-lui la documentation officielle, ne le laissez pas deviner les noms des champs.
  • Relisez le code avant de passer en production, surtout ce qui écrit des données.
  • Ne confiez pas de clés de données réelles à un agent qui travaille sur votre ordinateur.

Si vous voulez consulter les données de l'établissement depuis votre assistant, sans programmer, ce qu'il vous faut est un connecteur MCP. Nous l'expliquons dans ce qu'est MCP et à quoi il sert dans un établissement.

L'API d'Edena

  • Plus de 800 opérations couvrant tous les modules : élèves, familles, factures, encaissements, présences, CRM, emplois du temps et le reste. Chaque écran a son opération.
  • 240 types d'événements par webhook, signés en HMAC-SHA256 et renvoyés pendant environ trois jours si votre système ne répond pas. Les événements des 30 derniers jours peuvent être consultés.
  • Bac à sable : une copie vide de l'établissement avec ses propres clés, d'où ne partent ni e-mails, ni avis aux familles, ni envois à VeriFactu en production, ni paiements par carte.
  • Des clés par rôle (administrateur ou gestionnaire, avec son sous-rôle), jusqu'à 25 actives par organisation et révocables immédiatement.
  • Des jetons d'utilisateur final pour que votre application agisse comme chaque famille.
  • Une référence OpenAPI publique en espagnol, catalan et anglais, des erreurs avec une clé stable et l'en-tête Idempotency-Key pour répéter des écritures sans doublon.
  • Limites : 300 requêtes par minute par clé et 1 200 pour l'ensemble des clés de l'organisation.
  • Une CLI open source pour les personnes et les agents IA, et un journal de 30 jours avec chaque requête et chaque livraison de webhook.

Conclusion

Une API et des webhooks bien conçus sont ce qui empêche le logiciel de gestion de l'établissement d'être une île. Grâce à eux, le site, la comptabilité, la plateforme d'apprentissage ou votre propre application reçoivent les données sans que personne ne les recopie. Avant de commander une intégration, vérifiez que l'API de votre fournisseur est documentée, couvre tous les modules, dispose d'un environnement de test et de clés aux permissions délimitées.

Si votre établissement utilise déjà Edena, la console se trouve dans Développeurs, dans le menu de l'application. Si vous avez seulement besoin de l'API pour votre propre logiciel, vous pouvez créer une organisation de développement avec un essai de 15 jours. Découvrez la plateforme développeurs d'Edena ou parlez à l'équipe.

Questions fréquentes

Qu'est-ce que l'API d'un logiciel scolaire ?
C'est la porte par laquelle d'autres programmes peuvent lire et écrire des données dans le logiciel de gestion de l'établissement sans passer par ses écrans. Grâce à elle, votre site peut créer une demande d'admission, votre logiciel comptable peut recevoir les factures ou votre propre application peut montrer ses factures à une famille. Chaque requête se fait avec une clé dotée de permissions précises.
Qu'est-ce qu'un webhook ?
C'est un avis automatique que le logiciel de gestion envoie à un autre système quand quelque chose se produit : une nouvelle inscription, une facture payée, un appel effectué. Au lieu de demander toutes les cinq minutes si quelque chose a changé, votre système reçoit le changement au moment où il a lieu. Un bon webhook est signé, pour vérifier qu'il vient bien de qui il prétend, et renvoyé si votre système ne répond pas.
Faut-il une équipe de développement pour utiliser l'API ?
Pour une intégration sur mesure, oui : quelqu'un de l'équipe informatique, une agence ou un développeur externe. Aujourd'hui, les agents de programmation à IA comme Claude Code ou Codex réduisent beaucoup le travail si l'API dispose d'une documentation publique et d'un environnement de test. Pour des notifications simples, de nombreux outils d'automatisation acceptent les webhooks sans écrire de code.
Est-il sûr d'ouvrir les données de l'établissement à une API ?
Oui, si l'API est bien conçue : des clés avec le rôle minimum nécessaire, stockées sur le serveur et révocables immédiatement, des limites de requêtes, un journal de chaque appel, un environnement de test séparé des données réelles et des contrats de sous-traitance avec ceux qui développent. La clé ne doit jamais figurer dans le code d'une page web ou d'une application.
Que propose l'API d'Edena ?
Plus de 800 opérations couvrant tous les modules, 240 types d'événements par webhook signés en HMAC-SHA256 et renvoyés pendant environ trois jours, un bac à sable avec ses propres clés, des jetons pour que votre application agisse comme chaque famille, une référence OpenAPI publique en espagnol, catalan et anglais, une CLI open source et des limites de 300 requêtes par minute par clé et 1 200 par organisation.

Ce contenu a été généré par Ena, l'agent d'intelligence artificielle d'Edena. Il peut contenir des erreurs ou des inexactitudes et ne constitue pas un conseil juridique, fiscal ou professionnel. Edena ne garantit ni l'exactitude, ni l'exhaustivité, ni l'actualité des informations. Consultez les sources officielles et, le cas échéant, un professionnel qualifié avant toute décision. L'image de couverture provient d' Unsplash .

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