Partager via

Vue d’ensemble des fonctionnalités de l’API catalogue Microsoft Learn

L’API catalogue Microsoft Learn est une API web basée sur REST vous permet d’envoyer une requête web à Microsoft Learn et de récupérer des détails sur le contenu de formation et les examens de certification disponibles, tels que les titres, les produits couverts, les niveaux, les liens vers la formation et d’autres métadonnées, et retourne une réponse encodée JSON avec les informations.

Elle retourne des informations sur tous les éléments disponibles publiquement :

  • Modules
  • Unités
  • Parcours d’apprentissage
  • Compétences appliquées
  • Les certifications
  • Examens
  • Cours dispensés par un instructeur

Remarque

Un nouvel ensemble de points de terminaison d’API permettant d’accéder aux données du catalogue Microsoft Learn, qui remplace l’API Learn Catalog, est désormais disponible. Le point de terminaison existant décrit ici continuera de fonctionner jusqu’à mi-2026, mais il est prévu qu’il soit déprécié. Nous vous recommandons de migrer vers le nouveau point de terminaison pour tirer parti des fonctionnalités améliorées, notamment des paramètres de requête supplémentaires. Si vous souhaitez migrer vers les nouveaux points de terminaison de l’API catalogue, contactez LearnPlatformAPIMigration@microsoft.com.

Cas d’usage

  • Afficher les métadonnées relatives aux offres de formation et/ou de certification Microsoft Learn
  • Extrayez une liste des offres de formation et/ou de certification Microsoft Learn afin de les lier à partir de votre propre expérience en ligne

Fonctionnement de l’API Du catalogue Learn

L’API est une API web basée sur REST qui retourne une réponse encodée JSON. Pour demander le catalogue complet, envoyez une requête GET à :

https://learn.microsoft.com/api/catalog/

La sortie ressemble à la capture d’écran ci-dessous. Depuis novembre 2022, la réponse complète est d’environ 13 Mo.

capture d’écran de la sortie de l’API du catalogue Learn dans Visual Studio Code.

Chaque élément de catalogue d’apprentissage est un objet, avec un ensemble de métadonnées disponibles pour chacun d’eux. Le dictionnaire de données complet et d’autres options sont répertoriés dans la documentation développeur de l’API du catalogue Microsoft Learn. Nous avons également des notes de publication (lien) pour voir quelles sont les dernières mises à jour et des informations sur les bonnes pratiques.

Si vous souhaitez l’utiliser, consultez l'article "Prise en main de l’API catalogue Microsoft Learn à l’aide de cURL et Visual Studio Code".

Exigences

Aucune authentification n’est requise pour accéder à l’API catalogue Microsoft Learn. Les utilisateurs peuvent utiliser leur méthode de demande d’API préférée, telle que cURL, Postman, etc.

Exemples

Nous voyons les utilisateurs employer l'API du Catalogue Learn de plusieurs manières.

  • Viva Learning a utilisé l’API du catalogue Learn pour offrir le catalogue Microsoft Learn dans le cadre de son expérience principale.
  • Les organisations et les établissements d’enseignement utilisent l’API Learn Catalog pour extraire des informations de catalogue et les publier dans leurs systèmes de gestion de l’apprentissage interne (LMS), afin que leurs employés et étudiants puissent y accéder facilement.
  • Les fournisseurs d’apprentissage utilisent l’API Learn Catalog pour extraire des informations de catalogue et les publier dans leurs expériences d’apprentissage client.

Disponibilité et tarification

L’API du catalogue Microsoft Learn est disponible publiquement et proposée sous les conditions d'utilisation des API Microsoft. Il n’y a aucun frais pour utiliser l’API.

Limitations

  • L’API contient des modules disponibles publiquement, des unités, des parcours d’apprentissage, des cours dirigés par des instructeurs, des examens et des certifications. Il ne génère pas de documentation, d’exemples de code, d’affiches ou d’événements pour l’instant.
  • L’API actualise au moins une fois par jour.
  • Les mises à jour de la version de l’API seront communiquées via les mises à jour apportées aux Notes de publication de l’API du catalogue Learn.

Étapes suivantes

Pour en savoir plus sur l’API Learn Catalog, consultez les articles suivants :

  • Last updated on