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 Instructor-Led
Note
Dans le cadre de la mise à jour récente du site Microsoft Learn, il existe un nouveau point de terminaison d’API catalogue disponible sur le domaine learn.microsoft.com. L’ancien point de terminaison fonctionne toujours comme prévu, mais les avantages de passer au nouveau point de terminaison sont qu’il vous donnera des fonctionnalités améliorées telles que des paramètres de requête supplémentaires.
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.
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 meilleures pratiques informations.
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 de catalogue Learn .
Étapes suivantes
Pour en savoir plus sur l’API Learn Catalog, consultez les articles suivants :