Del via

Oversikt over Katalog-API for Microsoft Learn

  • Artikkel

Microsoft Learn-katalog-API-en er en REST-basert web-API som lar deg sende en nettbasert spørring til Microsoft Learn og få tilbake detaljer om tilgjengelig opplæringsinnhold og sertifiseringseksamener, for eksempel titler, produkter som dekkes, nivåer, koblinger til opplæring og andre metadata, og returnerer et JSON-kodet svar med informasjonen.

Den returnerer informasjon om alle offentlig tilgjengelige:

  • Moduler
  • Enheter
  • Læreprogrammer
  • Brukte ferdigheter
  • Sertifiseringer
  • Eksamener
  • Instructor-Led kurs

Notat

Som en del av den nylige oppdateringen for Microsoft Learn-nettstedet, er det et nytt katalog-API-endepunkt tilgjengelig på det learn.microsoft.com domenet. Det gamle endepunktet vil fortsatt fungere som forventet, men fordelene ved å bytte til det nye endepunktet er at det vil gi deg forbedrede funksjoner, for eksempel flere spørringsparametere.

Brukstilfeller

  • Vis metadata om opplærings- og/eller sertifiseringstilbud for Microsoft Learn
  • Hent en liste over Microsoft Learn-opplærings- og/eller sertifiseringstilbud for å koble til dem fra din egen opplevelse på nettet

Slik fungerer API-en for Learn-katalogen

API-en er en REST-basert web-API som returnerer et JSON-kodet svar. Hvis du vil be om hele katalogen, sender du en GET-forespørsel til:

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

Utdataene ligner på skjermbildet nedenfor. Fra og med november 2022 er den fullstendige responsen omtrent 13 MB.

Skjermbilde av Utdatakatalog-API-utdataene i Visual Studio Code.

Hvert læringskatalogelement er et objekt, med et sett med metadata tilgjengelig for hver. Den fullstendige dataordlisten og andre alternativer er oppført i Microsoft Learn Catalog API-utviklerdokumentasjon. Vi har også produktmerknader (kobling) for å se hva de nyeste oppdateringene er, og anbefalte fremgangsmåter informasjon.

Hvis du er interessert i å bruke den, kan du ta en titt på Kom i gang med katalog-API-en for Microsoft Learn ved hjelp av cURL- og Visual Studio Code-artikkelen.

Krav

Det kreves ingen godkjenning for å få tilgang til katalog-API-en for Microsoft Learn. Brukere kan bruke sin foretrukne API-forespørselsmetode, for eksempel cURL, Postman osv.

Eksempler

Nedenfor finner du noen av de mange måtene vi ser brukere på ved hjelp av learn-katalog-API-en:

  • Viva Learning har brukt Learn-katalog-API-en til å tilby Microsoft Learn-katalogen som en del av kjerneopplevelsen.
  • Organisasjoner og utdanningsinstitusjoner bruker learn-katalog-API-en til å hente kataloginformasjon og legge den inn i sine interne læringsstyringssystemer (LMS), slik at ansatte og studenter enkelt kan få tilgang til den.
  • Læringsleverandører bruker Learn Catalog-API-en til å hente kataloginformasjon og legge den inn i kundelæringsopplevelsene sine.

Tilgjengelighet og priser

Katalog-API-en for Microsoft Learn er offentlig tilgjengelig og tilbys i henhold til vilkårene for Microsoft API-er. Det er ingen kostnad å bruke API-en.

Begrensninger

  • API-en inneholder offentlig tilgjengelige moduler, enheter, læringsbaner, instruktørledede kurs, eksamener og sertifiseringer. Det utdatadokumentasjon, kodeeksempler, show eller hendelser på dette tidspunktet.
  • API-en oppdateres minst én gang per dag.
  • Oppdateringer av API-versjonen vil bli formidlet via oppdateringer til Produktmerknader for Learn Catalog API.

Neste trinn

Hvis du vil lære mer om learn-katalog-API-en, kan du se følgende artikler: