Oversikt over Katalog-API for Microsoft Learn
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æringsprogrammer
- Brukte ferdigheter
- Sertifiseringer
- Eksamener
- kurs ledet av instruktører
Merk
Som en del av den nylige Microsoft Learn-nettstedets oppdatering er det et nytt Catalog API-endepunkt tilgjengelig på learn.microsoft.com-domenet. Det gamle endepunktet vil fortsatt fungere som forventet, men fordelene med å bytte til det nye endepunktet er at det vil gi deg forbedrede funksjoner som ekstra spørringsparametere.
Brukssaker
- 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. For å be om hele katalogen, send 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.
Hvert læringskatalogelement er et objekt, med et sett med metadata tilgjengelig for hver. Den fullstendige dataordlisten og andre alternativer er oppført i utviklerdokumentasjonen for Microsoft Learn-katalogen. Vi har også produktmerknader (kobling) for å se hva de nyeste oppdateringene er, og informasjon om anbefalte fremgangsmåter .
Hvis du er interessert i å bruke den, kan du se artikkelen Kom i gang med Microsoft Learn-katalog-API-en ved hjelp av cURL og Visual Studio Code.
Forutsetninger
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 Læring 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æring leverandører bruker Learn-katalog-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 bruk av 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 til API-versjonen vil bli formidlet via oppdateringer til Lær produktmerknader for Katalog-API.
Neste trinn
Hvis du vil lære mer om learn-katalog-API-en, kan du se følgende artikler: