Übersicht über die Funktionen der Microsoft Learn-Katalog-API
Die Microsoft Learn-Katalog-API ist eine REST-basierte Web-API, mit der Sie eine webbasierte Abfrage an Microsoft Learn senden und Details zu den verfügbaren Schulungsinhalten und Zertifizierungsprüfungen wie Titeln, produkten abgedeckten Produkten, Ebenen, Links zu Schulungen und anderen Metadaten senden und eine JSON-codierte Antwort mit den Informationen zurückgeben können.
Sie gibt Informationen zu allen öffentlich verfügbaren Informationen zurück:
- Module
- Einheiten
- Lernpfade
- Angewandte Fähigkeiten
- Bescheinigungen
- Prüfungen
- Instructor-Led Kurse
Anmerkung
Als Teil des aktuellen Microsoft Learn-Websiteupdates ist ein neuer Katalog-API-Endpunkt in der learn.microsoft.com Domäne verfügbar. Der alte Endpunkt funktioniert weiterhin wie erwartet, aber die Vorteile des Wechsels zum neuen Endpunkt sind, dass er Ihnen erweiterte Features wie zusätzliche Abfrageparameter bietet.
Anwendungsfälle
- Anzeigen von Metadaten zu Microsoft Learn-Schulungs- und/oder Zertifizierungsangeboten
- Rufen Sie eine Liste der Microsoft Learn-Schulungs- und/oder Zertifizierungsangebote ab, um über Ihre eigene Onlineerfahrung mit ihnen zu verknüpfen.
Funktionsweise der Learn Catalog-API
Die API ist eine REST-basierte Web-API, die eine JSON-codierte Antwort zurückgibt. Um den vollständigen Katalog anzufordern, senden Sie eine GET-Anforderung an:
https://learn.microsoft.com/api/catalog/
Die Ausgabe sieht ähnlich wie der folgende Screenshot aus. Ab November 2022 beträgt die vollständige Antwort etwa 13 MB.
Jedes Lernkatalogelement ist ein Objekt, für das jeweils eine Reihe von Metadaten verfügbar ist. Das vollständige Datenwörterbuch und andere Optionen werden in der Microsoft Learn Catalog API-Entwicklerdokumentationaufgeführt. Wir haben auch Versionshinweise (Link), um die neuesten Updates einzusehen, und Informationen zu bewährten Methoden.
Wenn Sie daran interessiert sind, es zu verwenden, lesen Sie den Artikel Erste Schritte mit der Verwendung der Microsoft Learn-Katalog-API mithilfe von cURL und Visual Studio Code.
Anforderungen
Es ist keine Authentifizierung erforderlich, um auf die Microsoft Learn-Katalog-API zuzugreifen. Benutzer können ihre bevorzugte API-Anforderungsmethode verwenden, z. B. cURL, Postman usw.
Beispiele
Im Folgenden finden Sie einige der vielen Möglichkeiten, wie Benutzer die Learn Catalog-API verwenden:
- Viva Learning hat die Learn-Katalog-API verwendet, um den Microsoft Learn-Katalog als Teil seiner Kernerfahrung anzubieten.
- Organisationen und Bildungseinrichtungen verwenden die Learn Catalog-API, um Kataloginformationen abzurufen und in ihren internen Lernmanagementsystemen (LMS) zu veröffentlichen, damit ihre Mitarbeiter und Schüler problemlos darauf zugreifen können.
- Lernanbieter verwenden die Learn Catalog-API, um Kataloginformationen abzurufen und in ihren Kundenlernerfahrungen zu veröffentlichen.
Verfügbarkeit und Preise
Die Microsoft-Learn-Katalog-API ist öffentlich verfügbar und wird unter den Bedingungen der Microsoft-APIs Nutzungsbedingungenangeboten. Es gibt keine Gebühren für die Verwendung der API.
Begrenzungen
- Die API enthält öffentlich verfügbare Module, Einheiten, Lernpfade, kursleitergeführte Kurse, Prüfungen und Zertifizierungen. Zurzeit werden keine Dokumentation, Codebeispiele, Shows oder Ereignisse ausgegeben.
- Die API aktualisiert sich mindestens einmal pro Tag.
- Aktualisierungen der API-Version werden durch Änderungen an den Versionshinweisen der Learn Catalog APImitgeteilt.
Nächste Schritte
Weitere Informationen zur Learn Catalog API finden Sie in den folgenden Artikeln: