Oversigt over funktionsoversigt for Microsoft Learn-katalog-API

  • Artikel

Microsoft Learn Catalog API er en REST-baseret web-API, hvor du kan sende en webbaseret forespørgsel til Microsoft Learn og få oplysninger om det tilgængelige træningsindhold og certificeringseksamener, f.eks. titler, omfattede produkter, niveauer, links til oplæring og andre metadata og returnerer et JSON-kodet svar med oplysningerne.

Den returnerer oplysninger om alt offentligt tilgængeligt:

  • Moduler
  • Enheder
  • Læringsforløb
  • Anvendte færdigheder
  • Certificeringer
  • Eksamener
  • Instruktørledede kurser

Bemærk

Som en del af den seneste opdatering af Microsoft Learn-webstedet er der et nyt katalog-API-slutpunkt tilgængeligt på domænet learn.microsoft.com. Det gamle slutpunkt fungerer stadig som forventet, men fordelene ved at skifte til det nye slutpunkt er, at det giver dig forbedrede funktioner, f.eks. yderligere forespørgselsparametre.

Bruge sager

  • Få vist metadata om Microsoft Learn-kurser og/eller certificeringstilbud
  • Få vist en liste over Microsoft Learn-kurser og/eller certificeringstilbud for at linke til dem fra din egen onlineoplevelse

Sådan fungerer Learn Catalog-API'en

API'en er en REST-baseret web-API, der returnerer et JSON-kodet svar. Send en GET-anmodning for at anmode om det fulde katalog:

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

Outputtet ligner skærmbilledet nedenfor. Fra og med november 2022 er det fulde svar ca. 13 MB.

Screenshot of the Learn Catalog API output in Visual Studio Code.

Hvert element i læringskataloget er et objekt med et sæt metadata tilgængelige for hver enkelt. Den komplette dataordbog og andre indstillinger er angivet i udviklerdokumentationen til Microsoft Learn Catalog API. Vi har også produktbemærkninger (link) til at se, hvad de seneste opdateringer er, og oplysninger om bedste praksis .

Hvis du er interesseret i at bruge den, kan du se artiklen Kom i gang med Microsoft Learn Catalog-API'en ved hjælp af cURL og Visual Studio Code.

Krav

Der kræves ingen godkendelse for at få adgang til Microsoft Learn-katalog-API'en. Brugerne kan bruge deres foretrukne API-anmodningsmetode, f.eks. cURL, Postman osv.

Eksempler

Nedenfor kan du se nogle af de mange måder, vi ser brugere, der bruger Learn Catalog-API'en:

  • Viva Learning har brugt Learn Catalog-API'en til at tilbyde Microsoft Learn-kataloget som en del af dets kerneoplevelse.
  • Organisationer og uddannelsesinstitutioner bruger Learn Catalog-API'en til at hente katalogoplysninger og poste dem i deres interne LMS (Learning Management Systems), så deres medarbejdere og studerende nemt kan få adgang til dem.
  • Læringsudbydere bruger Learn Catalog-API'en til at hente katalogoplysninger og slå dem op i deres kundelæringsoplevelser.

Tilgængelighed og priser

Microsoft Learn Catalog-API'en er offentligt tilgængelig og tilbydes i henhold til Vilkårene for anvendelse af Microsoft API'er. Det er gratis at bruge API'en.

Begrænsninger

  • API'en indeholder offentligt tilgængelige moduler, enheder, læringsforløb, instruktørledede kurser, eksamener og certificeringer. Den skriver ikke dokumentation, kodeeksempler, shows eller hændelser på nuværende tidspunkt.
  • API'en opdaterer mindst én gang om dagen.
  • Opdateringer til API-versionen kommunikeres via opdateringer til Få mere at vide om produktbemærkninger til katalog-API' er.

Næste trin

Du kan få mere at vide om Learn Catalog-API'en i følgende artikler: