Jetons de l'API d'intégration
L’API d’intégration connecte les systèmes de votre organisation (RH, ERP, BI) à Eduvem : création de comptes et inscription automatiques, extraction de rapports, téléchargement de certificats et plus encore. Tout accès passe par des jetons créés par l’administrateur.
Créer et gérer les jetons
Section intitulée « Créer et gérer les jetons »- Créez plusieurs jetons nommés et indépendants - un par système intégré est la bonne pratique. Chacun peut être révoqué sans affecter les autres.
- La valeur du jeton n’est affichée qu’une seule fois, à la création. Conservez-la dans le coffre-fort de secrets de votre organisation : en cas de perte, la solution consiste à supprimer le jeton et à en créer un autre.
- Certaines données exigent une permission supplémentaire accordée sur le jeton : le téléchargement de certificats, l’historique d’audit des inscriptions et les rapports. N’accordez que ce que l’intégration utilise réellement.
Ce que fait l’intégration
Section intitulée « Ce que fait l’intégration »Création et mise à jour de participants (individuelle et en masse), gestion des groupes et des rôles, inscriptions et changements d’état (approuver, refuser, annuler, réactiver), liste et téléchargement des certificats en PDF, rapports (synthèse par salle et exportation par inscription), catalogue des salles et des contenus, et le classement.
Lors d’une inscription via l’API, le participant peut être identifié par e-mail ou CPF - s’il n’existe pas encore, le compte est créé automatiquement.
Chaque appel effectué via l’API est enregistré par la plateforme (quoi, quand et avec quel jeton). Cet enregistrement n’est pas affiché dans le panneau d’administration : si vous devez savoir ce qu’un système externe a fait, demandez la consultation au support Eduvem en indiquant le jeton et la période.
Limites d’utilisation
Section intitulée « Limites d’utilisation »- Le trafic est limité par institution (budget par défaut de 1 000 requêtes par minute, ajustable sur demande).
- Les opérations lourdes (exportations d’audit/de rapports et téléchargement de certificats) disposent d’un budget propre, plus faible - un pic sur celles-ci ne bloque pas le reste de l’intégration.
- Les listes sont paginées (100 éléments par page par défaut, 1 000 au maximum) : demandez aux intégrateurs de toujours paginer.
- La liste des certificats a une limite plus basse : 100 éléments par page au maximum (une page plus grande est refusée).