Vanliga frågor och svar om Microsoft Learn Catalog API
Den här artikeln innehåller vanliga frågor och svar om Api:et för Microsoft Learn-katalogen med deras svar och länkar till mer information efter behov.
Allmänt
F: Hur mycket kostar det att använda LEARN Catalog-API:et?
Det kostar ingenting att använda LEARN Catalog-API:et. Mer information finns i avsnittet Tillgänglighet och priser i artikeln Översikt över funktionsöversikten för Learn Catalog API.
F: Vilka är reglerna för att använda Learn Catalog-API:et?
Se användningsvillkoren för Microsoft Learn och Microsoft API.
F: Behöver jag registrera eller hämta nycklar för att använda LEARN Catalog-API:et?
Nej. API:et är offentligt tillgängligt. Se artikeln Komma igång med Learn Catalog API med hjälp av cURL och Visual Studio Code och/eller artikeln Utvecklarreferens för Learn Catalog API.
F: Kommer det här API:et att låta våra användare använda Learn-innehållet på vår plattform?
Nej. API:et för Learn Catalog innehåller metadata om innehållet och direkta länkar till innehållet. Användare kan integrera dessa länkar i valfritt LMS (Learning Management System) eller en webbupplevelse enligt Användningsvillkoren för Microsoft API.
F: Förblir de data som returneras från Learn Catalog-API:et statiska eller ändras?
Data ändras när nytt innehåll läggs till, ändras eller tas bort, vilket vanligtvis sker dagligen.
API-svar
F: Kan jag hämta alla data samtidigt?
Ja. Använd basslutpunkten learn.microsoft.com/api/catalog för att få det fullständiga svaret. Mer information om API-begäran finns i artikeln Om utvecklarreferens för Learn Catalog API.
F: Kan jag filtrera svaret i förväg?
Ja. Se de frågefilter som är tillgängliga i artikeln Utvecklarreferens för Learn Catalog API.
F: Är användargränssnitten unika för varje innehållsobjekt?
Ja. UID står för "Unikt ID" och är unikt för varje innehållsobjekt. Om ett UID ändras, även om rubriken eller andra metadata förblir desamma, betraktas innehållet som ett nytt objekt.
F: Varför finns det HTML-taggar i modulsammanfattningen?
Vi försöker vanligtvis hålla formateringen av sammanfattningen så rå som möjligt, men ibland måste vi betona eller länka viss text.
F: Varför finns det inga länkar för de enskilda enheterna?
Enheterna skrivs inte som fristående innehåll. De är avsedda att tas i en viss ordning för modulen. Det är av det här skälet vi inkluderar länken till modulinformationssidan och den första enheten, så att användarna kan börja där och fortsätta genom innehållet.
F: Hur kan jag se vilket innehåll som är nytt?
Värdet last_modified anger när posten senast ändrades.
F: Är enkel inloggning (SSO) aktiverat för innehållslänkarna?
Nej, inte just nu. Vi strävar efter att möjliggöra enkel inloggning i framtiden.
Innehåll
F: Är UID:t unikt för innehållet?
Ja. UID står för "Unikt ID" och är unikt för varje innehållsobjekt. Om ett UID ändras, även om rubriken eller andra metadata förblir desamma, betraktas innehållet som ett nytt objekt.
F: Är alla moduler en del av en utbildningsväg?
Nej. Moduler kan alla stå ensamma, i den meningen att de lär ut ett scenario eller koncept från slutpunkt till slutpunkt inom dem och inte kräver att du tar nödvändiga moduler. För vissa är detta allt, och de ingår inte som en del av någon utbildningsväg. Andra paketeras tillsammans i en eller flera utbildningsvägar där användaren får lära sig mer avancerade begrepp och färdigheter. En modul behöver inte vara en del av en utbildningsväg, men den kan också ingå i flera utbildningsvägar.
F: Hur gör jag för att vet när innehåll har lagts till, uppdaterats eller tagits bort?
När nya innehållsobjekt läggs till visas de som ett nytt objekt (identifieras av UID) i svaret. När innehållet ändras kan du se baserat på dess last_modified värde. När innehållet tas bort tas innehållsobjektet bort från svaret. Även om det ibland uppstår en liten fördröjning på innehåll som uppdateras i API-svaret, ser en användare alltid den senaste informationen när en användare följer URL:en till innehållet. När innehållet tas bort omdirigeras den gamla URL:en till det nya innehållet eller upplevelsen, eller till det näst bästa alternativet.
I synnerhet uppdateras innehållet hela tiden. Vi publicerar tillgängliga uppdateringar två gånger om dagen. De kan antingen vara mindre, till exempel mindre textändringar eller större, till exempel större revisioner, tillägg eller borttagningar. I allmänhet hanteras innehållsportföljen som ett massivt, starkt styrt projekt med öppen källkod med tusentals deltagare, och därför sker ändringar hela tiden. Om du använder Learn Catalog-API:et i produktionssystemet bör du vara medveten om detta och låta systemet hantera det.
F: Jag följde en bokmärkeslänk till innehåll, men nu visar den mig ett annat innehåll än jag förväntade mig. Varför?
Vi strävar efter att se till att ingen träffar en återvändsgränd (404) med länkar till vår webbplats. När innehållet ändras eller ersätts implementerar vi en omdirigering för den gamla länken som automatiskt tar dig till det nya innehållet. Om innehållet är inaktuellt och inte ersätts av olika skäl omdirigerar vi till nästa lämpliga innehåll, som kan vara ett något ändrat omfång, eller till en landningssida osv.
F: Hur gör jag för att få åtkomst till katalogerna för dokumentation, video och kodexempel?
Det finns för närvarande inget programmatiskt sätt att få åtkomst till dessa kataloger. Vi strävar efter att ge programmatisk åtkomst till dessa kataloger i framtiden.
Lokalisering
F: Vilka språk är tillgängliga i Microsoft Learn?
Det finns över 65 språk i Microsoft Learn. Du kan se en fullständig lista här via webbplatsfoten (välj det språk du visar för att se hela listan).
F: Är innehållet tillgängligt på andra språk?
Det beror på. Vi strävar efter att göra innehållet tillgängligt på alla språk som de produkter som lärs ut i innehållet är tillgängliga i. När elever besöker Microsoft Learn-webbplatsen på ett visst språk, om innehållet inte är tillgängligt i det nationella språket, ser användaren sidhuvud och sidfot i önskat språk och kärninnehållet återgår som standard till engelska tills en lokaliserad version är tillgänglig.
F: Är innehållet annorlunda för ett visst innehållsobjekt, beroende på vilket språk du visar det i?
Möjligen. När uppdateringar publiceras till det engelska innehållet fungerar våra lokaliseringspipelines för att få de lokaliserade versionerna uppdaterade så snart som möjligt – vanligtvis inom några dagar efter den ursprungliga ändringen.
Övrigt
F: Finns det några rapporterings-API eller funktioner för att hämta data, till exempel vyer, klick, slutförande?
Vi har inget rapporterings-API just nu. Vi har funktioner för organisationsrapportering som gör att organisationer kan rapportera om sina användares slutföranden.
Nästa steg
Du kan läsa mer om LEARN Catalog API genom att gå till följande länkar: