Overzicht van microsoft Learn Catalog-API-functies
De Microsoft Learn Catalog-API is een op REST gebaseerde web-API waarmee u een webquery naar Microsoft Learn kunt verzenden en details over de beschikbare trainingsinhoud en certificeringsexamens, zoals titels, producten die worden behandeld, niveaus, koppelingen naar training en andere metagegevens kunt verzenden en een met JSON gecodeerd antwoord met de informatie retourneert.
Deze retourneert informatie over alle openbaar beschikbare gegevens:
- Modules
- Eenheden
- Leertrajecten
- Toegepaste vaardigheden
- Certificeringen
- Examens
- Begeleide cursussen
Notitie
Als onderdeel van de recente update van de Microsoft Learn-site is er een nieuw Catalog API-eindpunt beschikbaar in het learn.microsoft.com-domein. Het oude eindpunt werkt nog steeds zoals verwacht, maar het voordeel van het overschakelen naar het nieuwe eindpunt is dat u verbeterde functies krijgt, zoals extra queryparameters.
Gebruiksgevallen
- Metagegevens over Microsoft Learn-trainings- en/of certificeringsaanbiedingen weergeven
- Haal een lijst op met de Microsoft Learn-trainings- en/of certificeringsaanbiedingen om deze te koppelen vanuit uw eigen online ervaring
Hoe de Learn Catalog-API werkt
De API is een op REST gebaseerde web-API die een met JSON gecodeerd antwoord retourneert. Om de volledige catalogus op te vragen, stuurt u een GET-verzoek naar:
https://learn.microsoft.com/api/catalog/
De uitvoer ziet er ongeveer uit zoals in de onderstaande schermopname. Vanaf november 2022 is het volledige antwoord ongeveer 13 MB.
Elk leercatalogusitem is een object, met een set metagegevens die voor elk item beschikbaar is. De volledige gegevenswoordenlijst en andere opties worden vermeld in de documentatie voor ontwikkelaars van de Microsoft Learn Catalog-API. We hebben ook releaseopmerkingen (koppeling) om te zien wat de meest recente updates zijn en informatie over aanbevolen procedures .
Als u geïnteresseerd bent in het gebruik ervan, raadpleegt u het artikel Aan de slag met de Microsoft Learn Catalog-API met behulp van cURL en Visual Studio Code.
Vereisten
Er is geen verificatie vereist voor toegang tot de Microsoft Learn Catalog-API. Gebruikers kunnen hun voorkeurs-API-aanvraagmethode gebruiken, zoals cURL, Postman, enzovoort.
Voorbeelden
Hieronder vindt u een aantal van de vele manieren waarop gebruikers de Learn Catalog-API gebruiken:
- Viva Learning heeft de Learn Catalog-API gebruikt om de Microsoft Learn-catalogus als onderdeel van de kernervaring aan te bieden.
- Organisaties en onderwijsinstellingen gebruiken de Learn Catalog-API om catalogusinformatie op te halen en te posten in hun interne leerbeheersystemen (LMS), zodat hun werknemers en studenten er eenvoudig toegang toe hebben.
- Leerproviders gebruiken de Learn Catalog-API om catalogusgegevens op te halen en te posten in hun leerervaringen voor klanten.
Beschikbaarheid en prijzen
De Microsoft Learn Catalog-API is openbaar beschikbaar en wordt aangeboden onder de voorwaarden van de Gebruiksvoorwaarden voor Microsoft-API's. Er worden geen kosten in rekening gebracht voor het gebruik van de API.
Beperkingen
- De API bevat openbaar beschikbare modules, eenheden, leertrajecten, cursussen met docent, examens en certificeringen. Er worden momenteel geen documentatie, codevoorbeelden, shows of gebeurtenissen uitgevoerd.
- De API vernieuwt ten minste één keer per dag.
- Updates voor de API-versie worden gecommuniceerd via updates voor de releaseopmerkingen van de Learn Catalog-API.
Volgende stappen
Raadpleeg de volgende artikelen voor meer informatie over de Learn Catalog-API: