Veelgestelde vragen over de Api voor Microsoft Learn Catalog
In dit artikel vindt u veelgestelde vragen over de Microsoft Learn Catalog-API, met de antwoorden en koppelingen naar meer informatie, indien nodig.
V: Hoeveel kost het om de Learn Catalog-API te gebruiken?
Er zijn geen kosten verbonden aan het gebruik van de Learn Catalog-API. Zie de sectie Beschikbaarheid en prijzen van het overzichtsartikel over de Learn Catalog-API-functie voor meer informatie.
V: Wat zijn de regels voor het gebruik van de Learn Catalog-API?
Zie de gebruiksvoorwaarden voor Microsoft Learn en Microsoft API.
V: Moet ik onboarden of sleutels ophalen voor het gebruik van de Learn Catalog-API?
Nee De API is openbaar beschikbaar. Zie het artikel Aan de slag met de Learn Catalog-API met cURL en Visual Studio Code en/of het naslagartikel over ontwikkelaars van de Learn Catalog-API.
V: Kunnen onze gebruikers met deze API de Learn-inhoud binnen ons platform gebruiken?
Nee De Learn Catalog-API biedt metagegevens over de inhoud en directe koppelingen naar de inhoud. Gebruikers kunnen deze koppelingen integreren in elk Learning Management System (LMS) of webervaring volgens de gebruiksvoorwaarden van de Microsoft-API.
V: Blijven de gegevens die worden geretourneerd uit de Learn Catalog-API statisch of worden gewijzigd?
De gegevens worden gewijzigd wanneer nieuwe inhoud wordt toegevoegd, gewijzigd of verwijderd, meestal dagelijks.
V: Kan ik alle gegevens tegelijk ophalen?
Ja. Gebruik het basiseindpunt learn.microsoft.com/api/catalog om het volledige antwoord te krijgen. Zie het naslagartikel over ontwikkelaars van de Learn Catalog-API voor meer informatie over API-aanvragen.
V: Kan ik het antwoord vooraf filteren?
Ja. Zie de queryfilters die beschikbaar zijn in het naslagartikel over ontwikkelaars van de Learn Catalog-API.
V: Zijn de UID's uniek voor elk inhoudsobject?
Ja. UID staat voor 'Unieke id' en is uniek voor elk inhoudsobject. Als een UID wordt gewijzigd, zelfs als de titel of andere metagegevens hetzelfde blijven, wordt de inhoud beschouwd als een nieuw object.
V: Waarom zijn er HTML-tags in de samenvatting van de module?
Meestal proberen we de opmaak van de samenvatting zo onbewerkt mogelijk te houden, maar soms moeten we bepaalde tekst benadrukken of koppelen.
V: Waarom zijn er geen koppelingen voor de afzonderlijke eenheden?
De eenheden worden niet geschreven als zelfstandige inhoud. Ze zijn bedoeld om in een specifieke volgorde voor de module te worden genomen. Daarom voegen we de koppeling naar de detailpagina van de module en de eerste eenheid, zodat gebruikers daar kunnen beginnen en verder kunnen gaan met de inhoud.
V: Hoe kan ik vertellen welke inhoud nieuw is?
De last_modified waarde geeft aan wanneer de record voor het laatst is gewijzigd.
V: Is eenmalige aanmelding (SSO) ingeschakeld voor de inhoudskoppelingen?
Op dit moment niet. We streven ernaar om eenmalige aanmelding in de toekomst mogelijk te maken.
V: Is de UID uniek voor inhoud?
Ja. UID staat voor 'Unieke id' en is uniek voor elk inhoudsobject. Als een UID wordt gewijzigd, zelfs als de titel of andere metagegevens hetzelfde blijven, wordt de inhoud beschouwd als een nieuw object.
V: Maken alle modules deel uit van een leertraject?
Nee Modules zijn allemaal in staat om alleen te staan, in de zin dat ze een scenario of concept end-to-end in deze modules leren en geen vereiste modules nodig hebben. Voor sommigen is dit het en ze maken geen deel uit van een leertraject. Voor anderen zijn ze gebundeld in een of meer leertrajecten die een gebruiker begeleiden bij het bouwen van geavanceerdere concepten. Een module hoeft geen deel uit te maken van een leertraject of kan deel uitmaken van een of meer.
V: Hoe kan ik weten wanneer inhoud is toegevoegd, vernieuwd of verwijderd?
Wanneer er nieuwe inhoudsobjecten worden toegevoegd, worden ze weergegeven als een nieuw object (geïdentificeerd door UID) in het antwoord. Wanneer inhoud wordt gewijzigd, kunt u dit zien op basis van de last_modified waarde. Wanneer inhoud wordt verwijderd, wordt het inhoudsobject verwijderd uit het antwoord. Hoewel er soms een kleine vertraging optreedt bij het bijwerken van inhoud in het API-antwoord, zien ze altijd de meest recente informatie wanneer een gebruiker de URL naar de inhoud volgt. Wanneer inhoud wordt verwijderd, wordt de oude URL omgeleid naar de nieuwe inhoud of ervaring of naar de volgende beste optie.
Inhoud wordt met name steeds bijgewerkt. We publiceren beschikbare updates twee keer per dag. Ze kunnen secundair zijn, zoals kleine tekstwijzigingen of primaire wijzigingen, zoals primaire revisies, toevoegingen of verwijderingen. Over het algemeen wordt het inhoudsportfolio beheerd als een enorm, uiterst beheerd opensource-project met duizenden inzenders, en als zodanig gebeuren er voortdurend wijzigingen. Als u de Learn Catalog-API in uw productiesysteem gebruikt, moet u hiervan op de hoogte zijn en moet u ervoor zorgen dat uw systeem dit kan verwerken.
V: Ik heb een koppeling met bladwijzers naar inhoud gevolgd, maar er wordt nu een ander stukje inhoud weergegeven dan ik had verwacht. Waarom?
We streven ernaar om ervoor te zorgen dat niemand een impasse raakt (404) met koppelingen naar onze site. Wanneer inhoud wordt gewijzigd of vervangen, implementeren we een omleiding voor de oude koppeling die u automatisch naar de nieuwe inhoud leidt. In het geval dat inhoud om verschillende redenen wordt afgeschaft en niet wordt vervangen, wordt u omgeleid naar de volgende meest geschikte inhoud, die mogelijk een enigszins gewijzigd bereik of een landingspagina is, enzovoort.
V: Hoe kan ik toegang krijgen tot de documentatie-, video- en codevoorbeeldcatalogussen?
Er is op dit moment geen programmatische manier om toegang te krijgen tot deze catalogi. We streven ernaar om programmatische toegang tot deze catalogi in de toekomst mogelijk te maken.
V: Welke talen zijn beschikbaar in Microsoft Learn?
Er zijn meer dan 65 landinstellingen beschikbaar in Microsoft Learn. U kunt hier een volledige lijst zien via de sitevoettekst (selecteer de taal die u bekijkt om de volledige lijst weer te geven).
V: Is de inhoud beschikbaar in andere talen?
Dat hangt ervan af. We streven ernaar om de inhoud beschikbaar te maken in alle talen waarin de producten die in de inhoud worden geleerd, beschikbaar zijn. Wanneer cursisten de Microsoft Learn-site bezoeken in een bepaalde landinstelling, als de inhoud niet beschikbaar is in die landinstelling, ziet de gebruiker de kop- en voettekst in de gewenste landinstelling en wordt de kerninhoud teruggezet naar het Engels totdat een gelokaliseerde versie beschikbaar is.
V: Is de inhoud anders voor een bepaald inhoudsobject, afhankelijk van de taal waarin u deze bekijkt?
Mogelijk. Wanneer updates worden gepubliceerd naar de Engelse inhoud, werken onze lokalisatiepijplijnen om de gelokaliseerde versies zo snel mogelijk bijgewerkt te krijgen, meestal binnen een paar dagen na de oorspronkelijke wijziging.
V: Is er een rapportage-API of functionaliteit om gegevens op te halen, zoals weergaven, klikken, voltooiing?
Op dit moment hebben we geen rapportage-API. We hebben wel functionaliteit voor organisatierapportage waarmee organisaties kunnen rapporteren over de voltooiing van hun gebruikers.
Ga naar de volgende koppelingen voor meer informatie over de Learn Catalog-API: