Résumé des API disponibles

Les API d'Udemy Business permettent l'intégration via plusieurs méthodes différentes pour vous offrir plus de flexibilité dans le développement de vos logiciels.  Cet article présente quelques-unes des utilisations possibles pour chaque API ainsi que des recommandations pour choisir celles qui vous conviennent.

Table des matières

Cours et tous les objets d'apprentissage

API de cours GraphQL - Protocole : GraphQL 

  • La nouvelle génération et la version avancée de l'API de cours traditionnelle. GraphQL vous permet, pour chaque cours, de récupérer uniquement les métadonnées de cours spécifiées. De plus, le système de requêtes de GraphQL vous renvoie les cours qui correspondent à vos critères. 

Remarque : pour en savoir plus sur la technologie derrière GraphQL, consultez la page de l'organisation GraphQL.

API de tous les objets d'apprentissage GraphQL  - Protocole : GraphQL 

  • Au-delà des cours, Udemy propose de nombreuses façons d'apprendre.  Nous fournissons tous les objets d'apprentissage par le biais d'une API pour les intégrer à votre système.  Cette API vous permet d'obtenir les cours, les exercices d'application et les badges.  Comme pour les autres services GraphQL, vous pouvez utiliser les requêtes pour récupérer uniquement les objets et les champs spécifiés.

Documentation :  pour accéder à la documentation GraphQL, vous devez avoir accès à Udemy Business. Consultez le portail des développeurs à l'URL suivante : https://{votre_sous-domaine}.udemy.com/dev-portal/api-reference/

Génération de rapports

API de génération de rapports - Protocole : RESTful 

  • Cette API contient toutes les données utilisateur collectées sur la progression, la complétion et les actions effectuées dans le cadre de l'apprentissage.  Vous pouvez choisir de récupérer les données de rapport de tous les utilisateurs ou spécifier un groupe d'utilisateurs. En raison de la quantité de données, les actions des utilisateurs sont collectées et rapportées en différé.

Documentation : Documentation API Udemy Business - API RESTful

xAPI - Protocole : xAPI

  • Génération de rapports en temps réel, transmis via un webhook, conçue selon les normes xAPI EdTech.  Udemy vous envoie en temps réel les données de progression et de rapport.  Les données contenues dans ces événements en temps réel ont une portée moindre par rapport à l'API de génération de rapports RESTful.

Documentation : Documentation xAPI Udemy Business

Parcours d'apprentissage

API de parcours d'apprentissage - Protocole : RESTful 

  • Udemy permet aux participants et aux administrateurs A&D de créer des parcours d'apprentissage, une collection de plusieurs cours et tout autre type d'objet d'apprentissage, y compris des liens externes. Nous fournissons ces parcours d'apprentissage via une API et renvoyons tous les parcours et les éléments qu'ils contiennent.

Documentation : Documentation API Udemy Business - API RESTful

Authentification unique (SSO)

Udemy Business peut se connecter à tous les services d'authentification unique SAML 2.0, qui incluent la plupart des fournisseurs de SSO. Des intégrations SSO personnalisées sont également disponibles, à condition qu'elles suivent la norme SAML 2.0.

Protocole : SAML 2.0 ou version ultérieure

Documentation : Présentation de l'authentification unique Udemy Business et de ses fonctionnalités principales

API de provisionnement des utilisateurs SCIM - Le provisionnement SCIM (System for Cross-domain Identity Management) vous permet de provisionner et de déprovisionner des licences utilisateur. Ce système permet à vos équipes informatiques ou à vos intégrations personnalisées d'automatiser la gestion des licences.

Protocole : SCIM

Documentation : ​​Provisionnement SCIM (System for Cross-domain Identity Management)

Ancienne API de cours 

API de cours  - Protocole : RESTful 

  • L'API de cours suit les normes traditionnelles EdTech. Elle récupère toutes les métadonnées d'un seul cours ou de l'ensemble des cours.

Remarque : il s'agit de notre ancienne API de cours, pour laquelle nous ne publierons plus de nouvelles fonctionnalités.  Toutes les nouvelles fonctionnalités sortiront sur nos API GraphQL, qui ne contiennent pas seulement les cours, mais aussi tous les objets d'apprentissage.

Documentation : Documentation API Udemy Business - API RESTful

Intégrations recommandées

Nous savons que chaque client et partenaire d'Udemy est différent et a des besoins uniques. Pour bénéficier de la meilleure intégration, nous vous recommandons d'utiliser les API suivantes :

1. Cours et objets d'apprentissage : utilisez l'API GraphQL pour accéder à tous les objets d'apprentissage

2. Génération de rapports : utilisez l'API REST pour l'ensemble des données et complétez-la avec xAPI pour obtenir des données en temps réel

3. SSO : doit être utilisé avec le SCIM pour automatiser le provisionnement et le déprovisionnement des utilisateurs

4. Parcours d'apprentissage : utilisez l'API de parcours d'apprentissage pour permettre aux administrateurs A&D et aux responsables des programmes de créer des parcours d'apprentissage pour l'utilisateur final

Articles associés

Contactez-nous