Naslagdocumentatie voor ontwikkelaars voor Microsoft Learn Catalog-API
Dit artikel bevat informatie voor ontwikkelaars en aanvragers die de Microsoft Learn Catalog-API implementeren. We raden u ook aan de best practices voor de Learn Catalog-API, releaseopmerkingen en artikelen met veelgestelde vragen te bekijken om uw ontwikkelingstraject te ondersteunen.
API-eindpunt
De Microsoft Learn Catalog-API is een OP REST gebaseerde web-API die een met JSON gecodeerd antwoord retourneert. Om de volledige catalogus op te vragen, stuurt u een GET-verzoek naar:
https://learn.microsoft.com/api/catalog/
Notitie
Het hierboven vermelde eindpunt is het huidige eindpunt. Als u een ander, ouder eindpunt gebruikt, werkt het nog steeds zoals verwacht toen u onboarding werd uitgevoerd, maar het voordeel van het overschakelen naar het nieuwe eindpunt is dat u verbeterde functies krijgt, zoals extra queryparameters.
Queryparameters
De volgende queryparameters kunnen deel uitmaken van de aanvraag. Alle zijn optioneel. U moet de waarden voor de queryparameter naar URL coderen. U kunt het eindpunt gebruiken met geen, één, sommige of al deze parameters.
Belangrijk
Als u meer dan één gebruikt, wordt de query beoordeeld met behulp van de operator AND.
| Naam | Waarde | Type | Vereist | voorbeeld |
|---|---|---|---|---|
| landinstellingen | Een geldige landinstelling uit de lijst met ondersteunde landinstellingen. De geretourneerde metagegevens zijn dan overeenkomstig de aangevraagde landinstellingen, indien beschikbaar. Als deze parameter niet is opgegeven, wordt het en-us antwoord geretourneerd. |
tekenreeks | Nee | ?locale=en-us |
| type | Een door komma's gescheiden lijst met een of meer inhouds- of taxonomieobjecten op het hoogste niveau die momenteel worden opgegeven in het antwoord dat moet worden geretourneerd. Ondersteunde waarden zijn: modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, , exams, courses, levels, roles. subjectsproducts |
tekenreeks | Nee | ?type=modules,learningPaths |
| uid | Een door komma's gescheiden lijst met een of meer geldige unieke inhouds-id's (uid) van de beschikbare inhoudstypen. Opmerking: UID's zijn hoofdlettergevoelig. | tekenreeks | Nee | ?uid=learn.azure.intro-to-azure-fundamentals |
| last_modified | Een operator en datum/tijd om te filteren op de laatste wijzigingsdatum van objecten. Operator omvat lt (kleiner dan), lte (kleiner dan of gelijk aan), eq (gelijk aan), gt (groter dan), gte (groter dan of gelijk aan). Wanneer u deze parameter gebruikt, wordt de operator standaard ingesteld op gte indien niet opgegeven. |
tekenreeks | Nee | ?last_modified=gte 2022-01-01 |
| populariteit | Een operator en waarde om te filteren op de populariteitswaarde (in een bereik van 0-1) van objecten. Operator omvat lt (kleiner dan), lte (kleiner dan of gelijk aan), eq (gelijk aan), gt (groter dan), gte (groter dan of gelijk aan). Wanneer u deze parameter gebruikt, wordt de operator standaard ingesteld op gte indien niet opgegeven. |
tekenreeks | Nee | ?popularity=gte 0.5 |
| niveau | Een door komma's gescheiden lijst met een of meer van de niveaus die momenteel beschikbaar zijn (volledige lijst bevindt zich in het niveauobject van het API-antwoord). | tekenreeks | Nee | ?level=beginner |
| role | Een door komma's gescheiden lijst met een of meer van de rollen die momenteel beschikbaar zijn (volledige lijst bevindt zich in het rolobject van het API-antwoord). | tekenreeks | Nee | ?role=developer |
| product | Een door komma's gescheiden lijst met een of meer van de rollen die momenteel beschikbaar zijn (volledige lijst bevindt zich in het productobject van het API-antwoord). De API biedt geen ondersteuning voor producthiërarchie, dus voeg elk product toe aan de lijst die u wilt opnemen in uw query. | tekenreeks | Nee | ?product=azure |
| subject | Een door komma's gescheiden lijst met een of meer van de rollen die momenteel beschikbaar zijn (volledige lijst bevindt zich in het onderwerpobject van het API-antwoord). De API biedt geen ondersteuning voor de onderwerphiërarchie, dus voeg elk onderwerp toe aan de lijst die u wilt opnemen in uw query. | tekenreeks | Nee | ?subject=cloud-computing |
Voorbeeldquery's
De onderstaande query's zijn voorbeelden waarmee u een idee krijgt van wat u kunt aanvragen en hoe u de aanvraag kunt indienen.
| Omschrijving | Query’s uitvoeren |
|---|---|
| Alle items in de Learn Catalog-API | https://learn.microsoft.com/api/catalog/ |
| Alle Spaanse modules | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| Alle modules met een populariteitsscore van 0,9 of hoger | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Alle beveiligingstrainings- en certificeringsobjecten voor beginners | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Alle geavanceerde toegankelijkheidsmodules met een populariteitsscore van meer dan 0,5 en bijgewerkt in de afgelopen maand | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
API-reactie
De service retourneert mogelijk de volgende HTTP-statuscodes.
| Statuscode | Omschrijving |
|---|---|
| 200 | Geslaagd. De hoofdtekst van het antwoord bevat de met JSON gecodeerde gegevens. |
| 400 | Een van de queryparameters ontbreekt of is ongeldig. |
| 404 | De URL is niet gevonden op de server. |
| 500 | Onverwachte serverfout. |
| 503 | De services zijn tijdelijk niet beschikbaar. |
Een geslaagde reactie bevat details over alle modules en leertrajecten, zoals hieronder wordt weergegeven.
Hoofdtekst van de reactie
Een geslaagde antwoordtekst wordt gecodeerd in JSON en bevat 12 secties:
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
Elke matrix heeft een of meer met JSON gecodeerde objecten die gegevens bevatten die specifiek zijn voor die sectie van de reactie.
modules: is een matrix met gepubliceerde modules.units: is een matrix met gepubliceerde eenheden.learningPaths: is een matrix met gepubliceerde leertrajecten.appliedSkills: is een matrix van gepubliceerde toegepaste vaardigheden.mergedCertifications: is een matrix van gepubliceerde certificeringen die zijn samengevoegd met examens.certifications: is een matrix met gepubliceerde certificeringen.exams: is een matrix met gepubliceerde examens.courses: is een matrix van gepubliceerde trainingscursussen onder begeleiding van een instructeur.levels: is een matrix met mogelijke doelgroepniveaus.products: is een matrix met mogelijke producten en services die in de catalogus aan de orde komen.roles: is een matrix met mogelijke functies.subjects: is een matrix met mogelijke onderwerptags.
Modulerecords
Modulerecords
Elk modulerecord heeft de volgende vorm:
{
"summary": "Explore the core concepts of cloud computing and how it can help your business.",
"levels": [
"beginner"
],
"roles": [
"administrator",
"business-analyst",
"developer"
],
"products": [
"azure",
"azure-portal",
"azure-resource-manager"
],
"subjects": [
"data-visualization"
],
"uid": "learn.principles-cloud-computing",
"type": "module",
"title": "Cloud Concepts - Principles of cloud computing",
"duration_in_minutes": 62,
"rating": {
count: 2014,
average: 4.84
},
"popularity": 0.8839785477023878,
"icon_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing.svg",
"social_image_url": "https://learn.microsoft.com/learn/achievements/principles-cloud-computing-social.png",
"locale": "en-us",
"last_modified": "2018-09-24T00:00:00Z",
"url": "https://learn.microsoft.com/learn/modules/principles-cloud-computing",
"firstUnitUrl": "https://learn.microsoft.com/learn/modules/principles-cloud-computing/1-introduction",
"units": [
"learn.principles-cloud-computing.1-introduction",
"learn.principles-cloud-computing.2-types-of-cloud-computing",
"learn.principles-cloud-computing.3-benefits-of-cloud-computing",
"learn.principles-cloud-computing.4-categories-of-cloud-services",
"learn.principles-cloud-computing.5-knowledge-check",
"learn.principles-cloud-computing.6-summary"
],
"number_of_children": 6
}
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
summary |
tekenreeks | Een tekenreeks met een korte beschrijving van de module. De waarde wordt uitgedrukt als een HTML-alineacode met de interne tekst als samenvatting. |
levels |
matrix tekenreeksen | Een lijst met de niveaus die zijn gekoppeld aan deze module, die aangeven hoeveel ervaring in de rol nodig is om alle aspecten van deze module te begrijpen. Naar details van de eenheden kan worden verwezen in de niveaurecords. |
roles |
matrix tekenreeksen | Een lijst met de functies waarvoor deze module relevant is. |
products |
matrix tekenreeksen | Een lijst met relevante producten die in deze module aan de orde komen. Details over de producten kunnen worden vermeld in de productrecords. |
subjects |
matrix tekenreeksen | Een lijst met relevante onderwerpen die in dit leertraject aan de orde komen. |
uid |
tekenreeks | Een unieke id voor deze module: deze waarde is uniek binnen MS Learn. |
type |
tekenreeks | Het type record. De waarde zal altijd 'module' zijn. |
title |
tekenreeks | De titel voor de module overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
duration_in_minutes |
geheel getal | De gemiddelde tijd die het kost om deze module te voltooien in minuten. |
rating |
object | Bevat zowel count, het aantal mensen dat de module heeft beoordeeld als average, een aggregatie van de classificaties, die 1-5 is |
popularity |
dubbel | Een genormaliseerde waarde van 0-1 die de populariteit van de module aangeeft |
icon_url |
tekenreeks | Een volledig gekwalificeerde URL naar een SVG-afbeelding van 100x100 die de prestatieafbeelding van de module vertegenwoordigt met een transparante achtergrond. |
social_image_url |
tekenreeks | Een volledig gekwalificeerde URL naar een PNG-afbeelding die de prestatieafbeelding van de module vertegenwoordigt met een rechthoekige ondoorzichtige achtergrond, geschikt voor sociale media of tegelervaringen. Als deze niet beschikbaar is voor deze module, wordt deze eigenschap niet geretourneerd in het antwoord. |
locale |
tekenreeks | De taal waarin deze JSON-gegevens zijn geschreven. Deze waarde is de aangevraagde landinstelling, indien beschikbaar, of 'en-us' als dat niet het geval is. |
last_modified |
datum | De laatste keer dat deze module een grote revisie heeft ondergaan. |
url |
tekenreeks | Een volledig gekwalificeerde URL naar de Learn-module overeenkomstig de aangevraagde landinstelling. |
firstUnitUrl |
tekenreeks | Een volledig gekwalificeerde URL naar de eerste eenheid van de Learn-module overeenkomstig de aangevraagde landinstelling. |
units |
matrix tekenreeksen | Een lijst met de gekoppelde eenheid-UID's. Naar details van de eenheden kan worden verwezen in de eenheidrecords. |
number_of_children |
geheel getal | Het aantal pagina's (eenheden) die deze module bevat. |
Eenheidsrecords
Elk eenheidrecord heeft de volgende vorm:
{
"uid": "learn.azure.fundamental-azure-concepts.types-of-cloud-computing",
"type": "unit",
"title": "Discuss different types of cloud models",
"duration_in_minutes": 5,
"locale": "en-us",
"last_modified": "2021-12-09T02:45:00+00:00"
},
Notitie
De eenheidsrecord heeft niet de bijbehorende URL omdat eenheden niet zijn 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 toe aan de modulerecord, zodat gebruikers daar kunnen beginnen en verder kunnen gaan met de inhoud. De eenheidsrecords kunnen echter worden gebruikt om details op te halen over de eenheden die moeten worden weergegeven in LMS's of andere ervaringen.
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
uid |
tekenreeks | Een unieke id voor deze module: deze waarde is uniek binnen MS Learn. |
type |
tekenreeks | Het type record. De waarde zal altijd 'eenheid' zijn. |
title |
tekenreeks | De titel voor de eenheid overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
duration_in_minutes |
De duur van de eenheid. Als u alle duration_in_minutes van de eenheden toevoegt die aan elke module zijn gekoppeld, krijgt u de totale moduletijd. | |
locale |
tekenreeks | De taal waarin deze JSON-gegevens zijn geschreven. Deze waarde is de aangevraagde landinstelling, indien beschikbaar, of 'en-us' als dat niet het geval is. |
last_modified |
datum | De laatste keer dat deze module een grote revisie heeft ondergaan. |
Leertrajectrecords
Elk leertrajectrecord heeft de volgende vorm:
{
"summary": "Azure Functions enable the creation of event driven, compute-on-demand systems that can be triggered by various external events. Learn how to leverage functions to execute server-side logic and build serverless architectures.",
"levels": [
"beginner",
"intermediate"
],
"roles": [
"developer",
"solution-architect"
],
"products": [
"azure",
"azure-portal",
"azure-functions",
"azure-cosmos-db",
"azure-cloud-shell"
],
"subjects": [
"data-visualization"
],
"uid": "learn.create-serverless-applications",
"type": "learningPath",
"title": "Create serverless applications",
"duration_in_minutes": 450,
"rating": {
count: 2014,
average: 4.84
},
"popularity": 0.8839785477023878,
"icon_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications.svg",
"social_image_url": "https://learn.microsoft.com/learn/achievements/create-serverless-applications-social.png",
"locale": "en-us",
"last_modified": "2018-12-27T00:00:00Z",
"url": "https://learn.microsoft.com/learn/paths/create-serverless-applications",
"firstModuleUrl": "https://learn.microsoft.com/learn/modules/choose-azure-service-to-integrate-and-automate-business-processes/",
"modules": [
"learn.choose-azure-service-to-integrate-and-automate-business-processes",
"learn.create-serverless-logic-with-functions",
"learn.execute-azure-function-with-triggers",
"learn.chain-azure-functions-data-using-input-output-bindings",
"learn.azure-create-long-running-serverless-workflow-with-durable-functions",
"learn-pr.develop-test-deploy-azure-functions-core-tools",
"learn.develop-test-deploy-azure-functions-with-visual-studio",
"learn.azure.monitor-github-events-with-a-function-triggered-by-a-webhook",
"learn.advocates.azure-functions-and-signalr"
],
"number_of_children": 9
}
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
summary |
tekenreeks | Een tekenreeks met een korte beschrijving van het leertraject. De waarde wordt uitgedrukt als een HTML-alineacode met de interne tekst als samenvatting. |
levels |
matrix tekenreeksen | Een lijst met de niveaus die zijn gekoppeld aan dit leertraject, die aangeven hoeveel ervaring in de rol nodig is om alle aspecten van dit leertraject te begrijpen. Naar details van de eenheden kan worden verwezen in de niveaurecords. |
roles |
matrix tekenreeksen | Een lijst met de relevante functies voor dit leertraject. |
products |
matrix tekenreeksen | Een lijst met relevante producten die in dit leertraject aan de orde komen. Details over de producten kunnen worden vermeld in de productrecords. |
subjects |
matrix tekenreeksen | Een lijst met relevante onderwerpen die in dit leertraject aan de orde komen. |
uid |
tekenreeks | Een unieke id voor dit leertraject: deze waarde is uniek binnen MS Learn. |
type |
tekenreeks | Het type record. De waarde zal altijd learningPath zijn. |
title |
tekenreeks | De titel voor het leertraject overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
duration_in_minutes |
geheel getal | De gemiddelde tijd die het kost om dit leertraject te voltooien in minuten. Deze waarde is een som van de gegevens van alle modules die er deel van uitmaken. |
rating |
object | Bevat zowel count, het aantal mensen dat het leertraject heeft beoordeeld als average, een aggregatie van de classificaties, die 1-5 is |
popularity |
dubbel | Een genormaliseerde waarde van 0-1 die de populariteit van het leertraject aangeeft |
icon_url |
tekenreeks | Een volledig gekwalificeerde URL naar een SVG-afbeelding van 100x100 die het leertraject weergeeft. |
social_image_url |
tekenreeks | Een volledig gekwalificeerde URL naar een PNG-afbeelding die de prestatieafbeelding van het leertraject vertegenwoordigt met een rechthoekige ondoorzichtige achtergrond, geschikt voor sociale media of tegelervaringen. Als deze niet beschikbaar is voor deze module, wordt deze eigenschap niet geretourneerd in het antwoord. |
locale |
tekenreeks | De taal waarin deze JSON-gegevens zijn geschreven. Deze waarde is de aangevraagde landinstelling, indien beschikbaar, of 'en-us' als dat niet het geval is. |
last_modified |
datum | De laatste keer dat dit leertraject is gewijzigd. |
url |
tekenreeks | Een volledig gekwalificeerde URL naar het leertraject in Microsoft Learn overeenkomstig de aangevraagde landinstelling. |
firstModuleUrl |
tekenreeks | Een volledig gekwalificeerde URL naar de eerste module van het leertraject in Microsoft Learn overeenkomstig de aangevraagde landinstelling. |
modules |
matrix tekenreeksen | Een lijst met de gekoppelde module UID's. Naar details van de modules kan worden verwezen in de modulerecords. |
number_of_children |
geheel getal | Het aantal modules in dit leertraject. |
Records voor toegepaste vaardigheden
Elke record voor toegepaste vaardigheden heeft het volgende formulier:
{
"uid": "applied-skill.deploy-and-configure-azure-monitor",
"locale": "en-us",
"url": "https://learn.microsoft.com/en-us/credentials/applied-skills/deploy-and-configure-azure-monitor/?WT.mc_id=api_CatalogApi",
"title": "Deploy and configure Azure Monitor",
"summary": "<p>To earn this Microsoft Applied Skills credential, learners demonstrate the ability to deploy and configure monitoring for Azure infrastructure.</p>\n<p>Candidates for this assessment lab should be familiar with operating systems, networking, servers, and virtualization.</p>\n",
"levels": [
"intermediate"
],
"roles": [
"administrator"
],
"products": [
"azure-monitor",
"azure-virtual-machines",
"azure-virtual-network",
"windows-server"
],
"subjects": [
"it-management-monitoring"
],
"study_guide": [
{
"uid": "learn.wwl.deploy-configure-azure-monitor",
"type": "learningPath"
}
],
"last_modified": "2023-10-25T17:07:00+00:00"
}
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
uid |
tekenreeks | Een unieke id voor deze toegepaste vaardigheid. Deze waarde is uniek in alle MS Learn-bestanden. |
locale |
tekenreeks | De taal waarin deze JSON-gegevens zijn geschreven. Deze waarde is de aangevraagde landinstelling, indien beschikbaar, of 'en-us' als dat niet het geval is. |
title |
tekenreeks | De titel voor de toegepaste vaardigheid in de aangevraagde landinstelling of Amerikaans Engels als een terugval. |
summary |
tekenreeks | De samenvatting voor de toegepaste vaardigheid in de aangevraagde landinstelling of Amerikaans Engels als een terugval. |
url |
tekenreeks | Een volledig gekwalificeerde URL naar de toegepaste vaardigheid in Microsoft Learn in de aangevraagde landinstelling. |
icon_url |
tekenreeks | Een volledig gekwalificeerde URL naar een SVG-afbeelding van 100x100 die de toegepaste vaardigheid vertegenwoordigt (indien beschikbaar, anders niet opgenomen). |
levels |
matrix tekenreeksen | Een lijst met de niveaus die zijn gekoppeld aan deze toegepaste vaardigheid. |
roles |
matrix tekenreeksen | Een lijst met de relevante taakrollen voor deze toegepaste vaardigheid. Naar details van de rollen kan worden verwezen in de rolrecords. |
subjects |
matrix tekenreeksen | Een lijst met relevante onderwerpen die door deze toegepaste vaardigheid worden behandeld. |
study_guide |
matrix van objecten | Een lijst met de bijbehorende inhoud die moet worden onderzocht voor deze toegepaste vaardigheid. Naar details van de objecten kan worden verwezen in de bijbehorende records. |
last_modified |
datum | De laatste keer dat deze toegepaste vaardigheid is gewijzigd. |
Samengevoegde certificeringsrecords
Elke samengevoegde certificeringsrecord heeft het volgende formulier:
{
"uid": "certification.d365-functional-consultant-manufacturing",
"title": "Microsoft Certified: Dynamics 365 Supply Chain Management, Manufacturing Functional Consultant Associate",
"summary": "<div class=\"WARNING\">\n<p>Warning</p>\n<p>This certification retired on June 30, 2023. You can renew it for at least six months after the retirement date by completing the free online assessment available on the <a href=\"/credentials/certifications/d365-functional-consultant-manufacturing/renew\">certification renewal page</a>. <a href=\"https://aka.ms/BACertPortfolioUpdatesBlog\">Read the blog post</a>.</p>\n</div>\n<p>If you’re a functional consultant or a business user with a deep understanding of manufacturing industry standards, this certification might be for you. You also need experience configuring and implementing Dynamics 365 Supply Chain Management to meet the needs of your organization. Supply chain management, manufacturing functional consultants are key resources who work with developers, solution architects, project managers, and functional consultants in finance, commerce, and supply chain.</p>\n<p>If you need more experience before you try to earn this certification, here are some suggestions:</p>\n<ul>\n<li>Study the supply chain management and supply chain management, manufacturing modules on Microsoft Learn, and complete more hands-on practice.</li>\n<li>Sign up for an instructor-led training course that covers the MB-300 or MB-320 track.</li>\n<li>Take part in the community at <a href=\"https://community.dynamics.com/\">community.dynamics.com</a>, or join a user group.</li>\n<li>Shadow a manufacturing functional consultant in a manufacturing workstream.</li>\n<li>Get a mentor, tour manufacturing lines, and learn how things are made.</li>\n<li>Ask questions, and learn from experts and customers.</li>\n</ul>\n",
"url": "https://learn.microsoft.com/en-us/credentials/certifications/d365-functional-consultant-manufacturing/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/en-us/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
"last_modified": "2023-09-19T00:47:00+00:00",
"type": "cert",
"certification_type": "role-based",
"products": [
"dynamics-365",
"dynamics-finance"
],
"levels": [
"intermediate"
],
"roles": [
"functional-consultant"
],
"subjects": [],
"renewal_frequency_in_days": 0,
"prerequisites": [],
"skills": [
"Describe finance and operations apps, and extend apps by using Microsoft Power Platform technologies",
"Configure administrative features and workflows",
"Manage finance and operations data",
"Validate and support solutions",
"Configure Dynamics 365 Supply Chain Management, Manufacturing",
"Manage manufacturing processes",
"Implement master planning for production",
"Implement other manufacturing features"
],
"recommendation_list": [],
"study_guide": [],
"exam_duration_in_minutes": 0,
"locales": [],
"providers": [],
"career_paths": []
}
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
uid |
tekenreeks | Een unieke id voor deze certificering: deze waarde is uniek binnen MS Learn. |
title |
tekenreeks | De titel voor de certificering overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
summary |
tekenreeks | De samenvatting voor de certificering in de aangevraagde landinstelling of Amerikaans Engels als terugval. |
url |
tekenreeks | Een volledig gekwalificeerde URL naar de certificering in Microsoft Learn overeenkomstig de aangevraagde landinstelling. |
icon_url |
tekenreeks | Een volledig gekwalificeerde URL naar een SVG-afbeelding van 100x100 die de certificering weergeeft. |
last_modified |
datum | De laatste keer dat deze certificering is gewijzigd. |
type |
tekenreeks | Het type record. De waarde zal altijd 'cert' zijn. |
certification_type |
tekenreeks | Het type certificering. De mogelijke waarden zijn 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
products |
matrix tekenreeksen | Een lijst met relevante producten die door deze certificering worden behandeld. Details over de producten kunnen worden vermeld in de productrecords. |
levels |
matrix tekenreeksen | Een lijst met de niveaus die zijn gekoppeld aan deze certificering, die aangeven hoeveel ervaring in de rol nodig is om alle aspecten van de examens van deze certificering te begrijpen. Naar details van de eenheden kan worden verwezen in de niveaurecords. |
roles |
matrix tekenreeksen | Een lijst met de relevante functies voor deze certificering. Naar details van de rollen kan worden verwezen in de rolrecords. |
subjects |
matrix tekenreeksen | Een lijst met relevante onderwerpen die door deze certificering worden behandeld. |
renewal_frequency_in_days |
geheel getal | Het aantal dagen voordat deze certificering verloopt en moet worden verlengd. Als de waarde 0 is, verloopt de certificering niet. |
prerequisites |
matrix tekenreeksen | Een lijst met de aanbevolen vereisten om deze certificering te verdienen. Informatie over de certificeringen kan worden verwezen in de certificeringsrecords. |
skills |
matrix tekenreeksen | Een lijst met de vaardigheden die zijn gemeten op het examen dat is vereist voor deze certificering. |
recommendation_list |
matrix tekenreeksen | Een lijst met de aanbevolen taken met betrekking tot deze certificering. |
study_guide |
matrix van objecten | Een lijst met de bijbehorende inhoud die moet worden onderzocht voor deze certificering. Naar details van de objecten kan worden verwezen in de bijbehorende records. |
exam_duration_in_minutes |
geheel getal | Het aantal minuten dat is toegewezen om het examen te voltooien. |
locales |
matrix tekenreeksen | Een lijst met de talen waarin deze certificering wordt aangeboden. |
providers |
matrix van objecten | Een lijst met providers voor deze certificering. Het type beschrijft welke provider en een volledig gekwalificeerde URL met een koppeling om een examen met de provider te plannen. |
career_paths |
matrix van objecten | Een lijst met carrièretrajecten voor deze certificering. |
Notitie
Certificeringen waarvoor slechts één examen is vereist, worden geretourneerd als onderdeel van deze samengevoegde eigenschapCertifications.
Certificeringsrecords
Elk certificeringsrecord heeft de volgende vorm:
{
"uid": "certification.d365-functional-consultant-customer-service",
"title": "Microsoft Certified: Dynamics 365 Customer Service Functional Consultant Associate",
"subtitle": "Microsoft Dynamics 365 Customer Service functional consultants are responsible for implementing omnichannel solutions that focus on service, quality, reliability, efficiency, and customer satisfaction.",
"url": "https://learn.microsoft.com/cert-exam-sandbox/cert/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/media/learn/certification/badges/microsoft-certified-associate-badge.svg",
"type": "cert",
"certification_type": "role-based",
"exams": [
"exam.77-881"
],
"levels": [
"intermediate"
],
"roles": [
"functional-consultant"
],
"study_guide": [
{
"uid": "learn.get-started-with-d365",
"type": "module"
},
{
"uid": "learn.d365-notebook",
"type": "module"
},
{
"uid": "learn.d365-fundamentals",
"type": "learningPath"
}
]
}
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
uid |
tekenreeks | Een unieke id voor deze certificering: deze waarde is uniek binnen MS Learn. |
title |
tekenreeks | De titel voor de certificering overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
subtitle |
tekenreeks | De subtitel voor de certificering overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
url |
tekenreeks | Een volledig gekwalificeerde URL naar de certificering in Microsoft Learn overeenkomstig de aangevraagde landinstelling. |
icon_url |
tekenreeks | Een volledig gekwalificeerde URL naar een SVG-afbeelding van 100x100 die de certificering weergeeft. |
type |
tekenreeks | Het type record. De waarde zal altijd 'cert' zijn. |
certification_type |
tekenreeks | Het type certificering. De mogelijke waarden zijn 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
exams |
matrix tekenreeksen | Een lijst met de bijbehorende examens die vereist zijn voor deze certificering. Naar details van de eenheden kan worden verwezen in de certificeringsrecords. |
levels |
matrix tekenreeksen | Een lijst met de niveaus die zijn gekoppeld aan deze certificering, die aangeven hoeveel ervaring in de rol nodig is om alle aspecten van de examens van deze certificering te begrijpen. Naar details van de eenheden kan worden verwezen in de niveaurecords. |
roles |
matrix tekenreeksen | Een lijst met de relevante functies voor deze certificering. Naar details van de rollen kan worden verwezen in de rolrecords. |
study_guide |
matrix van objecten | Een lijst met de bijbehorende inhoud die moet worden onderzocht voor deze certificering. Naar details van de objecten kan worden verwezen in de bijbehorende records. |
Notitie
Certificeringen waarvoor meer dan één examen is vereist, zijn aanwezig in deze certificeringsrecord die verwijst naar de examenmatrix.
Examenrecords
Elk examenrecord heeft de volgende vorm:
{
"uid": "exam.77-881",
"title": "Word 2010",
"subtitle": "The core-level Microsoft Office Word 2010 user should be able to navigate Microsoft Office Word 2010 software at the feature and functional level. They should be familiar with and know how to use at least 80 percent of the features and capabilities of Microsoft Office Word 2010. The core-level user should be able to use Microsoft Office Word 2010 to create and edit professional-looking documents for a variety of purposes and situations. Users would include people from a wide variety of job roles from almost all areas of professional, student, and personal life.",
"display_name": "77-881",
"url": "https://learn.microsoft.com/cert-exam-sandbox/exam/77-881/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/media/learn/certification/badges/certification-exam.svg",
"pdf_download_url": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4trjX",
"practice_test_url": "https://www.mindhub.com/70-413-Designing-and-Implementing-a-Server-Infrast-p/mu-70-413_p.htm?utm_source=microsoft&utm_medium=certpage&utm_campaign=msofficialpractice",
"practice_assessment_url": "https://learn.microsoft.com/en-us/certifications/exams/{exam}/practice/assessment?assessment-type=practice&assessmentId={assessmentId}",
"locales": [],
"type": "exam",
"courses": [
"course.pl-200t00",
"course.mb-230t01"
],
"levels": [
"beginner"
],
"roles": [
"business-user"
],
"products": [
"office-word"
],
"providers": [],
"study_guide": [
{
"uid": "learn.get-started-with-word-2010",
"type": "module"
},
{
"uid": "learn.office2010-notebook",
"type": "module"
},
{
"uid": "learn.office2010-fundamentals",
"type": "learningPath"
}
]
}
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
uid |
tekenreeks | Een unieke id voor dit examen: deze waarde is uniek binnen MS Learn. |
title |
tekenreeks | De titel voor dit examen overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
subtitle |
tekenreeks | De subtitel voor dit examen overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
display_name |
tekenreeks | De schermnaam voor dit examen overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
url |
tekenreeks | Een volledig gekwalificeerde URL naar het examen in Microsoft Learn overeenkomstig de aangevraagde landinstelling. |
icon_url |
tekenreeks | Een volledig gekwalificeerde URL naar een SVG-afbeelding van 100x100 die het examen weergeeft. |
pdf_download_url |
tekenreeks | Een volledig gekwalificeerde URL naar het PDF-bestand met een overzicht van de vaardigheden die door dit examen zijn gemeten. |
practice_test_url |
tekenreeks | Een volledig gekwalificeerde URL naar een oefentest die is gekoppeld aan het examen. |
practice_assessment_url |
tekenreeks | Een volledig gekwalificeerde URL naar een gratis oefenevaluatie die is gekoppeld aan het examen. |
locales |
matrix tekenreeksen | Een lijst met talen waarin dit examen wordt aangeboden. |
type |
tekenreeks | Het type record. De waarde zal altijd 'exam' zijn. |
courses |
matrix tekenreeksen | Een lijst met de bijbehorende cursus-UID's. Details van de cursussen kunnen worden vermeld in de cursusrecords. |
levels |
matrix tekenreeksen | Een lijst met de niveaus die zijn gekoppeld aan dit examen, die aangeven hoeveel ervaring in de rol nodig is om alle aspecten van dit examen te begrijpen. Naar details van de eenheden kan worden verwezen in de niveaurecords. |
roles |
matrix tekenreeksen | Een lijst met de relevante functies voor dit examen. Naar details van de rollen kan worden verwezen in de rolrecords. |
products |
matrix tekenreeksen | Een lijst met relevante producten die in deze examen aan de orde komen. Details over de producten kunnen worden vermeld in de productrecords. |
providers |
matrix van objecten | Een lijst met providers voor dit examen. Het type beschrijft welke provider en een volledig gekwalificeerde URL met een koppeling om een examen met de provider te plannen. |
study_guide |
matrix van objecten | Een lijst met de bijbehorende inhoud die moet worden onderzocht voor dit examen. Naar details van de objecten kan worden verwezen in de bijbehorende records. |
Cursusrecords onder leiding van een instructeur
Elk cursusrecord heeft de volgende vorm:
{
"uid": "course.mb-230t01",
"course_number": "MB-230T01",
"title": "Microsoft Dynamics 365 Customer Service - added non-exist studyguide",
"summary": "Microsoft Dynamics 365 Customer Service offers any organization an opportunity for customer success. Using tools such as automatic case creation and queue management frees up your time to dedicate it where you can have a greater impact, directly with your customers. Join our team of globally recognized experts as they take you step by step from creating cases to interacting with customers to resolving those cases. Once you’ve resolved those cases you can learn from data analysis the key details to help you resolve similar cases faster or avoid new issues altogether. A Dynamics 365 Customer Engagement Functional Consultant is responsible for performing discovery, capturing requirements, engaging subject matter experts and stakeholders, translating requirements, and configuring the solution and applications. The Functional Consultant implements a solution using out of the box capabilities, codeless extensibility, application and service integrations.",
"duration_in_hours": 72,
"url": "https://learn.microsoft.com/cert-exam-sandbox/course/mb-230t01/?WT.mc_id=api_CatalogApi",
"icon_url": "https://learn.microsoft.com/media/learn/certification/course.svg",
"locales": [
"en"
],
"type": "course",
"certification": "certification.d365-functional-consultant-customer-service",
"exam": "exam.77-881",
"levels": [
"intermediate"
],
"roles": [
"functional-consultant"
],
"products": [
"dynamics-365"
],
"study_guide": [
{
"uid": "learn.align-requirements-in-azure",
"type": "module"
},
{
"uid": "learn.manage-resources-in-azure",
"type": "learningPath"
}
]
},
Velddetails
| Veld | Type | Omschrijving |
|---|---|---|
uid |
tekenreeks | Een unieke id voor deze begeleide cursus: deze waarde is uniek binnen MS Learn. |
course_number |
tekenreeks | De id van het nummer van de begeleide cursus. |
title |
tekenreeks | De titel voor de begeleide cursus overeenkomstig de aangevraagde landinstelling, of Amerikaans-Engels om op terug te vallen. |
summary |
tekenreeks | Een tekenreeks met een korte beschrijving van het begeleide cursus. De waarde wordt uitgedrukt als een HTML-alineacode met de interne tekst als samenvatting. |
duration_in_hours |
geheel getal | De gemiddelde tijd die deze begeleide cursus kost om in uren te voltooien. |
url |
tekenreeks | Een volledig gekwalificeerde URL naar de begeleide cursus in Microsoft Learn overeenkomstig de aangevraagde landinstelling. |
icon_url |
tekenreeks | Een volledig gekwalificeerde URL naar een 100x100 SVG-installatiekopieën die de begeleide cursusprestaties vertegenwoordigen. |
locales |
matrix tekenreeksen | Een lijst met talen waarin deze begeleide cursus officieel wordt aangeboden. Andere talen worden mogelijk ondersteund door lerende partners. |
type |
tekenreeks | Het type record. De waarde is altijd 'cursus' voor begeleide cursussen. |
certification |
tekenreeks | Certificering die is gekoppeld aan de begeleide cursus. |
exam |
tekenreeks | Examen dat is gekoppeld aan de begeleide cursus. |
levels |
matrix tekenreeksen | Een lijst met de niveaus die zijn gekoppeld aan deze begeleide cursus, die aangeven hoeveel ervaring in de rol nodig is om alle aspecten van deze cursus te begrijpen. Naar details van de eenheden kan worden verwezen in de niveaurecords. |
study_guide |
matrix van objecten | Een volledig gekwalificeerde URL naar het PDF-bestand met een overzicht van de vaardigheden die door deze certificering zijn gemeten. |
Records voor niveau, product, rol en onderwerp
De verzamelingen levels, products, roles en subjects hebben beschrijvende namen voor de waarden die worden gebruikt voor de gegevens van modules en leertrajecten. Alle vier de verzamelingen hebben dezelfde vorm:
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
De id komt overeen met de waarden voor niveaus, producten, rollen en onderwerpen die zijn opgenomen in de andere catalogusvermeldingen. De bijbehorende name biedt een geschikte naam voor de vermelding in het Engels. De matrix children is optioneel en kan hiërarchisch worden ingeschakeld voor waarden met onderliggende relaties, zoals producten.
Hier volgt een voorbeeld van een reeks mogelijke rollen:
{
...
"roles": [
{
"id": "administrator",
"name": "Administrator"
},
{
"id": "ai-engineer",
"name": "AI Engineer"
},
{
"id": "business-analyst",
"name": "Business Analyst"
},
{
"id": "developer",
"name": "Developer"
},
...
]
}
Hier volgt een voorbeeld van een reeks producten met onderliggende items die zijn opgenomen om een specifiekere productcategorie te kunnen bieden.
{
...
"products": [
{
"id": "dotnet",
"name": ".NET",
"children": [
{ "id": "dotnet-core", "name": ".NET Core" },
{ "id": "dotnet-standard", "name": ".NET Standard" },
{ "id": "aspnet-core", "name": "ASP.NET Core" },
{ "id": "ef-core", "name": "Entity Framework Core" }
]
},
{
"id": "ms-graph",
"name": "Microsoft Graph"
},
{
"id": "office",
"name": "Office",
"children": [
{ "id": "office-365", "name": "Office 365" },
{ "id": "office-add-ins", "name": "Office Add-ins" },
{ "id": "office-teams", "name": "Teams" }
]
},
{
"id": "sql-server",
"name": "SQL Server"
},
...
]
}
Codevoorbeelden
Er zijn veel manieren om de Learn Catalog-API aan te roepen, maar de onderstaande codevoorbeelden zijn voorbeelden van hoe deze kan worden gebruikt.
jQuery
$(function() {
var params = {
locale:'en-us'
};
$.ajax({
url: "https://learn.microsoft.com/api/learn/catalog?" + $.param(params),
type: "GET"
}).done(function(data) {
alert("success");
}).fail(function(error) {
alert("error");
});
})
.NET C#
public string GetCatalogData()
{
var client = new WebClient();
client.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko");
var response = client.DownloadString("https://learn.microsoft.com/api/learn/catalog?locale=en-us");
dynamic parsedJson = JsonConvert.DeserializeObject(response);
JsonConvert.SerializeObject(response, Formatting.Indented);
return Convert.ToString(response);
}
PHP met behulp van de cURL-extensie
<?php
// From URL to get webpage contents.
$url = "https://learn.microsoft.com/api/learn/catalog";
// Initialize a CURL session.
$ch = curl_init();
// Return Page contents.
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
//grab URL and pass it to the variable.
curl_setopt($ch, CURLOPT_URL, $url);
$result = curl_exec($ch);
echo $result;
?>
PYTHON 3 met behulp van de bibliotheek 'aanvragen'
#!/usr/bin/env python3
#Using Python 3.8.2 install 5/6/2020
import requests
import json
#if given error 'response / requests not defined', install requests via 'pip install requests' in the command line
parameters= {"locale": "en-us"}
response = requests.get("https://learn.microsoft.com/api/learn/catalog/", parameters)
#print(response.status_code)
rawJson = response._content
#Create python objects based on the data using json.loads
data = json.loads(rawJson)
print(data)
Volgende stappen
Bekijk de onderstaande bronnen om u te helpen bij uw ontwikkelingstraject: