Avec le connecteur API GET, les clients peuvent récupérer les données utilisateurs : achèvement de modules, résultats de tests, scores, achèvement de cours et données de phishing. La clé API et le secret API sont générés dans Modifier l'organisation.
À noter : cette fonctionnalité requiert une licence Freedom.
L'implémentation du connecteur API GET permet d'extraire efficacement les données utilisateurs et d'intégrer d'autres plateformes.
La configuration se trouve dans le menu Modifier l'organisation.
Exemple de configuration
Achèvement de cours par date par utilisateurPath: https://portal.2lrn4.com/api/courses
Header:
api_key
api_secret
Parameters:
date_from (optional, string, format: \"Y-m-d\")
date_to (optional, string, format: \"Y-m-d\")
users (optional, array)
Récupérer les formations ouvertes
Open trainings per userPath: https://portal.2lrn4.com/api/courses/open
Header:
api_key
api_secret
Parameters:
overdue_only (optional, boolean)
due_before (optional, string, format: "Y-m-d")
Ce point de terminaison renvoie par collaborateur les formations non terminées, avec l'échéance, si elle est dépassée, le nombre de jours de retard et la progression. Avec overdue_only et due_before, tu récupères en un appel qui est en retard. Les collaborateurs sans formation ouverte, les collaborateurs inactifs et les cours désactivés sont exclus. Le format de réponse complet figure dans la documentation de l'API.
Le secret d'API n'est affiché qu'une fois
Le secret d'API ne peut plus être relu dans la plateforme : il est affiché une seule fois, à sa création. Conserve-le à ce moment-là en lieu sûr, par exemple dans un coffre-fort de mots de passe. En cas de perte, génère un nouveau secret dans modifier l'organisation ; l'ancien cesse alors de fonctionner. Les intégrations existantes continuent de fonctionner tant que tu ne renouvelles pas le secret.