Referansedokumentasjon for Microsoft Learn Catalog API-utviklere
Denne artikkelen inneholder informasjon for utviklere og anmodere som implementerer katalog-API-en for Microsoft Learn. Vi anbefaler også å sjekke ut anbefalte fremgangsmåter for Learn Catalog API, produktmerknader og vanlige spørsmålsartikler for å støtte utviklingsreisen.
API-endepunkt
Katalog-API-en for Microsoft Learn 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/
Merk
Endepunktet oppført ovenfor er det gjeldende endepunktet. Hvis du bruker et annet, eldre endepunkt, vil det fortsatt fungere som forventet når du kom om bord, men fordelene med å bytte til det nye endepunktet er at det vil gi deg forbedrede funksjoner som ekstra spørringsparametere.
Spørringsparametere
Følgende er spørringsparametrene som forespørselen kan inkludere. Alle er valgfrie. Du må URL-kode verdiene for spørringsparameteren. Du kan bruke endepunktet med ingen, én, noen eller alle disse parameterne.
Viktig
Hvis du bruker mer enn én, vil søket bli vurdert ved hjelp av OG-operatoren.
| Name | Verdi | Type | Obligatorisk | Eksempel |
|---|---|---|---|---|
| nasjonal innstilling | En enkelt, gyldig nasjonal innstillingskode fra den støttede listen over nasjonale innstillinger. Metadataene som returneres, bruker den forespurte nasjonale innstillingen hvis den er tilgjengelig. Hvis denne parameteren ikke er oppgitt, returneres en-us-svaret. |
string | No | ?locale=en-us |
| type | En kommadelt liste over ett eller flere av innholds- eller taksonomieobjektene på øverste nivå vi for øyeblikket oppgir i svaret på retur. Støttede verdier er: modules, , units, learningPaths, certificationsappliedSkills, mergedCertifications, exams, courses, levels, roles, products. subjects |
string | No | ?type=modules,learningPaths |
| uid | En kommadelt liste over én eller flere gyldige unike innholds-ID-er (uid) fra de tilgjengelige innholdstypene. Merk: UID-er skiller mellom store og små bokstaver. | string | No | ?uid=learn.azure.intro-to-azure-fundamentals |
| sist endret | En operator og datetime for å filtrere etter siste endrede dato for objekter. Operatør inkluderer lt (mindre enn), lte (mindre enn eller lik), eq (lik), gt (større enn), gte (større enn eller lik). Når du bruker denne parameteren, vil operatøren som standard være gte hvis ikke spesifisert. |
string | No | ?last_modified=gte 2022-01-01 |
| popularitet | En operatør og verdi som skal filtreres etter popularitetsverdien (i området 0–1) til objekter. Operatør inkluderer lt (mindre enn), lte (mindre enn eller lik), eq (lik), gt (større enn), gte (større enn eller lik). Når du bruker denne parameteren, vil operatøren som standard være gte hvis ikke spesifisert. |
string | No | ?popularity=gte 0.5 |
| nivå | En kommadelt liste over ett eller flere av nivåene vi har tilgjengelig for øyeblikket (full liste er i nivåer-objektet i API-svaret). | string | No | ?level=beginner |
| rolle | En kommadelt liste over én eller flere av rollene vi har tilgjengelig for øyeblikket (full liste er i roller-objektet i API-svaret). | string | No | ?role=developer |
| produkt | En kommadelt liste over én eller flere av rollene vi har tilgjengelig for øyeblikket (full liste er i produkter-objektet i API-svaret). API-en støtter ikke produkthierarki, så legg til hvert produkt i listen du vil inkludere i spørringen. | string | No | ?product=azure |
| emne | En kommadelt liste over én eller flere av rollene vi har tilgjengelig for øyeblikket (full liste er i emner-objektet i API-svaret). API-en støtter ikke emnehierarki, så legg til alle emnene i listen du vil inkludere i spørringen. | string | No | ?subject=cloud-computing |
Eksempelspørringer
Forespørslene som er oppført nedenfor er eksempler for å hjelpe deg å få en følelse av hva du kan be om og hvordan du kan utforme forespørselen.
| Bekrivelse | Query |
|---|---|
| Alle elementer i Learn Catalog API | https://learn.microsoft.com/api/catalog/ |
| Alle spanske moduler | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| Alle moduler med et popularitetsresultat på 0,9 eller høyere | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Alle sikkerhetsopplærings- og sertifiseringsobjekter for nybegynnere | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Alle avanserte tilgjengelighetsmoduler med et popularitetsresultat på over 0,5 og oppdatert den siste måneden | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
API-svar
Tjenesten kan returnere følgende HTTP-statuskoder.
| Statuskode | Bekrivelse |
|---|---|
| 200 | Vellykket. Brødteksten i svaret inneholder de JSON-kodede dataene. |
| 400 | En av spørringsparameterne mangler eller er ugyldig. |
| 404 | Fant ikke nettadressen på serveren. |
| 500 | Uventet serverfeil. |
| 503 | Tjenesten er midlertidig utilgjengelig. |
Et vellykket svar inneholder informasjon om alle moduler og læreprogrammer, som vist nedenfor.
Svartekst
En vellykket svartekst blir kodet i JSON og har 12 inndelinger:
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
Hver matrise har ett eller flere JSON-kodede objekter som inneholder data som er spesifikke for den delen av svaret.
modules: en matrise med publiserte moduler.units: er en rekke publiserte enheter.learningPaths: en matrise med publiserte læreprogrammer.appliedSkills: er en matrise med publiserte anvendte ferdigheter.mergedCertifications: er en matrise med publiserte sertifiseringer som er slått sammen med eksamener.certifications: er en rekke publiserte sertifiseringer.exams: er en rekke publiserte eksamener.courses: er en rekke publiserte instruktørledede opplæringskurs.levels: en matrise med mulige publikumsnivåer.products: er en rekke mulige produkter og tjenester som dekkes i katalogen.roles: en matrise med mulige jobbroller.subjects: er en rekke mulige emnekoder.
Modulposter
Modulposter
Hver moduloppføring vil ha følgende form:
{
"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
}
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
summary |
string | En streng som gir en kort beskrivelse av modulen. Verdien uttrykkes som en HTML-avsnittskode der den indre teksten er sammendraget. |
levels |
matrise med strenger | En liste over nivåene knyttet til denne modulen, som indikerer hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter ved denne modulen. Detaljer om enhetene kan refereres til i nivåoppføringene. |
roles |
matrise med strenger | En liste over jobbrollene som denne modulen er relevant for. |
products |
matrise med strenger | En liste over relevante produkter som denne modulen dekker. Detaljer om produktene kan refereres til i produktoppføringene. |
subjects |
matrise med strenger | En liste over relevante emner som dette læringsforløpet dekker. |
uid |
string | En unik identifikator for denne modulen. Denne verdien er unik i hele MS Learn. |
type |
string | Posttypen. Verdien vil alltid være «module». |
title |
string | Tittelen på modulen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som reserve. |
duration_in_minutes |
heltall | Gjennomsnittstiden i minutter som det tar å fullføre denne modulen. |
rating |
objekt | Omfatter både count, som er antall personer som har vurdert modulen, og average, et samlet antall rangeringer som vil være 1–5 |
popularity |
dobbel | En normalisert verdi fra 0–1 som angir populariteten til modulen |
icon_url |
string | En fullstendig kvalifisert URL-adresse til et SVG-bilde på 100x100 som representerer modulprestasjonsbildet med en gjennomsiktig bakgrunn. |
social_image_url |
string | En fullt kvalifisert URL-adresse til et PNG-bilde som representerer modulprestasjonsbildet med en rektangulær ugjennomsiktig bakgrunn, egnet for sosiale medier eller flisopplevelser. Hvis den ikke er tilgjengelig for denne modulen, returneres ikke denne egenskapen i svaret. |
locale |
string | Språket disse JSON-dataene er skrevet på. Denne verdien er den forespurte nasjonale innstillingen hvis tilgjengelig, eller en-us hvis ikke. |
last_modified |
dato | Siste gang denne modulen gikk gjennom en større revisjon. |
url |
string | En fullstendig kvalifisert URL-adresse til Learn-modulen i den forespurte nasjonale innstillingen. |
firstUnitUrl |
string | En fullstendig kvalifisert URL-adresse til den første enheten i Learn-modulen i den forespurte nasjonale innstillingen. |
units |
matrise med strenger | En liste over de tilknyttede UID-er for enhet. Detaljer om enhetene kan refereres i enhetsoppføringene. |
number_of_children |
heltall | Antallet sider (enheter) i denne modulen. |
Enhetsoppføringer
Hver enhetsoppføring vil ha følgende form:
{
"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"
},
Merk
Enhetsoppføringen har ikke den tilknyttede URL-adressen fordi enheter ikke er skrevet som frittstående innhold. De er ment å bli tatt i en bestemt rekkefølge for modulen. Av denne grunn inkluderer vi koblingen til moduldetaljsiden og den første enheten i moduloppføringen slik at brukerne kan starte der og fortsette gjennom innholdet. Enhetsoppføringene kan imidlertid brukes til å få detaljer om enhetene som skal vises i LMS-er eller andre opplevelser.
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
uid |
string | En unik identifikator for denne modulen. Denne verdien er unik i hele MS Learn. |
type |
string | Posttypen. Verdien vil alltid være «enhet». |
title |
string | Tittelen for enheten i det aktuelle språket, eller amerikansk engelsk som en reserve. |
duration_in_minutes |
Enhetens varighet. Hvis du legger til all duration_in_minutes av enhetene knyttet til hver modul, får du den totale modultiden. | |
locale |
string | Språket disse JSON-dataene er skrevet på. Denne verdien er den forespurte nasjonale innstillingen hvis tilgjengelig, eller en-us hvis ikke. |
last_modified |
dato | Siste gang denne modulen gikk gjennom en større revisjon. |
Læreprogramposter
Hver læringsforløpoppføring vil ha følgende form:
{
"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
}
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
summary |
string | En streng som gir en kort beskrivelse av læreprogrammet. Verdien uttrykkes som en HTML-avsnittskode der den indre teksten er sammendraget. |
levels |
matrise med strenger | En liste over nivåene knyttet til dette læringsforløpet, som indikerer hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter ved dette læringsforløpet. Detaljer om enhetene kan refereres til i nivåoppføringene. |
roles |
matrise med strenger | En liste over de relevante jobbrollene for dette læreprogrammet. |
products |
matrise med strenger | En liste over relevante produkter som dette læreprogrammet dekker. Detaljer om produktene kan refereres til i produktoppføringene. |
subjects |
matrise med strenger | En liste over relevante emner som dette læringsforløpet dekker. |
uid |
string | En unik identifikator for dette læreprogrammet. Denne verdien er unik i hele MS Learn. |
type |
string | Posttypen. Verdien vil alltid være learningPath. |
title |
string | Tittelen på læreprogrammet i den forespurte nasjonale innstillingen, eller amerikansk engelsk som reserve. |
duration_in_minutes |
heltall | Gjennomsnittstiden i minutter som det tar å fullføre dette læreprogrammet. Denne verdien er summen av dataene fra alle de inkluderte modulene. |
rating |
objekt | Omfatter både count, som er antall personer som har vurdert læreprogrammet, og average, et samlet antall rangeringer som vil være 1–5 |
popularity |
dobbel | En normalisert verdi fra 0–1 som angir populariteten til læreprogrammet |
icon_url |
string | En fullt kvalifisert URL-adresse til et 100x100 SVG-bilde som representerer læringsforløpet. |
social_image_url |
string | En fullt kvalifisert URL til et PNG-bilde som representerer læringsforløpets prestasjonsbilde med en rektangulær ugjennomsiktig bakgrunn, egnet for sosiale medier eller flisopplevelser. Hvis den ikke er tilgjengelig for denne modulen, returneres ikke denne egenskapen i svaret. |
locale |
string | Språket disse JSON-dataene er skrevet på. Denne verdien er den forespurte nasjonale innstillingen hvis tilgjengelig, eller en-us hvis ikke. |
last_modified |
dato | Forrige gang dette læreprogrammet ble endret. |
url |
string | En fullstendig kvalifisert nettadresse til læreprogrammet i Microsoft Learn med forespurt nasjonal innstilling. |
firstModuleUrl |
string | En fullstendig kvalifisert URL-adresse til den første modulen i læreprogrammet i Microsoft Learn med forespurt nasjonal innstilling. |
modules |
matrise med strenger | En liste over de tilknyttede modul-UID-ene. Detaljer om modulene kan refereres til i moduloppføringene. |
number_of_children |
heltall | Antallet moduler i dette læreprogrammet. |
Brukte kompetanseposter
Hver oppføring for brukte ferdigheter har følgende skjema:
{
"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"
}
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
uid |
string | En unik identifikator for denne brukte kompetansen – denne verdien vil være unik på tvers av hele MS Learn. |
locale |
string | Språket disse JSON-dataene er skrevet på. Denne verdien er den forespurte nasjonale innstillingen hvis tilgjengelig, eller en-us hvis ikke. |
title |
string | Tittelen på anvendt kompetanse i den angitte nasjonale innstillingen, eller amerikansk engelsk som en tilbakefall. |
summary |
string | Sammendraget for anvendt kompetanse i den angitte nasjonale innstillingen, eller amerikansk engelsk som en tilbakefall. |
url |
string | En fullstendig url-adresse til anvendt kompetanse i Microsoft Learn i den forespurte nasjonale innstillingen. |
icon_url |
string | En fullstendig url-adresse til et SVG-bilde på 100 x 100 som representerer anvendt kompetanse (når tilgjengelig, ellers ikke inkludert). |
levels |
matrise med strenger | En liste over nivåene som er knyttet til denne anvendte kompetansen. |
roles |
matrise med strenger | En liste over de relevante jobbrollene for denne anvendte kompetansen. Detaljer om rollene kan refereres til i rolleoppføringene. |
subjects |
matrise med strenger | En liste over relevante emner denne anvendte kompetansen dekker. |
study_guide |
matrise over objekter | En liste over det tilknyttede innholdet som skal studeres for denne anvendte kompetansen. Detaljer om objektene kan refereres til i deres tilknyttede oppføringer. |
last_modified |
dato | Sist gang denne brukte kompetansen ble endret. |
Flettede sertifiseringsposter
Hver flettede sertifiseringspost har følgende skjema:
{
"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": []
}
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
uid |
string | En unik identifikator for denne sertifiseringen – denne verdien vil være unik i hele MS Learn. |
title |
string | Tittelen for sertifiseringen i det aktuelle språket, eller amerikansk engelsk som en reserve. |
summary |
string | Sammendraget for sertifiseringen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
url |
string | En fullstendig kvalifisert URL-adresse til sertifiseringen i Microsoft Learn på den forespurte nasjonale innstillingen. |
icon_url |
string | En fullstendig kvalifisert URL-adresse til et 100x100 SVG-bilde som representerer sertifiseringen. |
last_modified |
dato | Siste gang denne sertifiseringen ble endret. |
type |
string | Posttypen. Verdien vil alltid være «cert». |
certification_type |
string | Typen sertifisering. De mulige verdiene er «fundamentals», «mce», «mcsa», «mcsd», «mcse», «mos», «mta», «rollebasert», «spesialitet». |
products |
matrise med strenger | En liste over relevante produkter denne sertifiseringen dekker. Detaljer om produktene kan refereres til i produktoppføringene. |
levels |
matrise med strenger | En liste over nivåene knyttet til denne sertifiseringen, som indikerer hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter av eksamenene i denne sertifiseringen. Detaljer om enhetene kan refereres til i nivåoppføringene. |
roles |
matrise med strenger | En liste over relevante jobbroller for denne sertifiseringen. Detaljer om rollene kan refereres til i rolleoppføringene. |
subjects |
matrise med strenger | En liste over relevante emner denne sertifiseringen dekker. |
renewal_frequency_in_days |
heltall | Antall dager før denne sertifiseringen utløper og må fornyes. Hvis verdien er 0, utløper ikke sertifiseringen. |
prerequisites |
matrise med strenger | En liste over anbefalte forutsetninger for å oppnå denne sertifiseringen. Detaljer om sertifiseringene kan refereres til i sertifiseringspostene. |
skills |
matrise med strenger | En liste over ferdighetene som måles på eksamenen som kreves for denne sertifiseringen. |
recommendation_list |
matrise med strenger | En liste over anbefalte faktorer relatert til denne sertifiseringen. |
study_guide |
matrise over objekter | En liste over det tilknyttede innholdet som skal studeres for denne sertifiseringen. Detaljer om objektene kan refereres til i deres tilknyttede oppføringer. |
exam_duration_in_minutes |
heltall | Antall minutter tildelt for å fullføre eksamen. |
locales |
matrise med strenger | En liste over språkene denne sertifiseringen tilbys i. |
providers |
matrise over objekter | En liste over leverandører for denne sertifiseringen. Typen beskriver hvilken leverandør og en fullt kvalifisert URL-adresse med en kobling for å planlegge en eksamen med leverandøren. |
career_paths |
matrise over objekter | En liste over karriereveier for denne sertifiseringen. |
Merk
Sertifiseringer som bare krever én eksamen, returneres som en del av denne mergedCertifications-egenskapen.
Sertifiseringsoppføringer
Hver sertifiseringsoppføring vil ha følgende form:
{
"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"
}
]
}
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
uid |
string | En unik identifikator for denne sertifiseringen – denne verdien vil være unik i hele MS Learn. |
title |
string | Tittelen for sertifiseringen i det aktuelle språket, eller amerikansk engelsk som en reserve. |
subtitle |
string | Undertittelen for sertifiseringen på det aktuelle stedet, eller amerikansk engelsk som en reserve. |
url |
string | En fullstendig kvalifisert URL-adresse til sertifiseringen i Microsoft Learn på den forespurte nasjonale innstillingen. |
icon_url |
string | En fullstendig kvalifisert URL-adresse til et 100x100 SVG-bilde som representerer sertifiseringen. |
type |
string | Posttypen. Verdien vil alltid være «cert». |
certification_type |
string | Typen sertifisering. De mulige verdiene er «fundamentals», «mce», «mcsa», «mcsd», «mcse», «mos», «mta», «rollebasert», «spesialitet». |
exams |
matrise med strenger | En liste over tilknyttede eksamener som kreves for denne sertifiseringen. Detaljer om enhetene kan refereres til i sertifiseringsoppføringene. |
levels |
matrise med strenger | En liste over nivåene knyttet til denne sertifiseringen, som indikerer hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter av eksamenene i denne sertifiseringen. Detaljer om enhetene kan refereres til i nivåoppføringene. |
roles |
matrise med strenger | En liste over relevante jobbroller for denne sertifiseringen. Detaljer om rollene kan refereres til i rolleoppføringene. |
study_guide |
matrise over objekter | En liste over det tilknyttede innholdet som skal studeres for denne sertifiseringen. Detaljer om objektene kan refereres til i deres tilknyttede oppføringer. |
Merk
Sertifiseringer som krever mer enn én eksamen, vil være til stede i denne sertifiseringsposten som refererer til eksamensmatrisen.
Eksamensoppføringer
Hver eksamensoppføring vil ha følgende form:
{
"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"
}
]
}
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
uid |
string | En unik identifikator for denne eksamenen – denne verdien vil være unik i hele MS Learn. |
title |
string | Tittelen for eksamen i det aktuelle språket, eller amerikansk engelsk som en reserve. |
subtitle |
string | Underteksten for eksamen i det aktuelle språket, eller amerikansk engelsk som en reserve. |
display_name |
string | Visningsnavnet for eksamenen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som en reserve. |
url |
string | En fullstendig kvalifisert URL-adresse til eksamen i Microsoft Learn på den forespurte nasjonale innstillingen. |
icon_url |
string | En fullstendig kvalifisert URL-adresse til et SVG-bilde på 100x100 som representerer eksamenen. |
pdf_download_url |
string | En fullstendig kvalifisert URL-adresse til PDF-en som viser ferdighetene som er målt ved denne eksamenen. |
practice_test_url |
string | En fullstendig kvalifisert URL-adresse til en øvingsprøve knyttet til eksamen. |
practice_assessment_url |
string | En fullstendig nettadresse til en gratis praksisvurdering knyttet til eksamen. |
locales |
matrise med strenger | En liste over språk denne eksamenen tilbys på. |
type |
string | Posttypen. Verdien vil alltid være «eksamen». |
courses |
matrise med strenger | En liste over tilknyttede kurs-UID-er. Detaljer om emnene kan vises i emneoppføringene. |
levels |
matrise med strenger | En liste over nivåene knyttet til denne eksamenen, som indikerer hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter ved denne eksamenen. Detaljer om enhetene kan refereres til i nivåoppføringene. |
roles |
matrise med strenger | En liste over relevante jobbroller for denne eksamenen. Detaljer om rollene kan refereres til i rolleoppføringene. |
products |
matrise med strenger | En liste over relevante produkter denne eksamenen dekker. Detaljer om produktene kan refereres til i produktoppføringene. |
providers |
matrise over objekter | En liste over tilbydere for denne eksamenen. Typen beskriver hvilken leverandør og en fullt kvalifisert URL-adresse med en kobling for å planlegge en eksamen med leverandøren. |
study_guide |
matrise over objekter | En liste over det tilknyttede innholdet som skal studeres til denne eksamenen. Detaljer om objektene kan refereres til i deres tilknyttede oppføringer. |
Instruktørledede kursoppføringer
Hver kursoppføring vil ha følgende form:
{
"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"
}
]
},
Feltdetaljer
| Felt | Type | Bekrivelse |
|---|---|---|
uid |
string | En unik identifikator for dette instruktørledede kurset – denne verdien vil være unik i hele MS Learn. |
course_number |
string | Den instruktørledede kursnummeridentifikatoren. |
title |
string | Tittelen for det instruktørledede kurset på det aktuelle stedet, eller amerikansk engelsk som en reserve. |
summary |
string | En streng som gir en kort beskrivelse av den instruktørledede. Verdien uttrykkes som en HTML-avsnittskode der den indre teksten er sammendraget. |
duration_in_hours |
heltall | Gjennomsnittlig tid dette instruktørledede kurset tar å fullføre i timer. |
url |
string | En fullstendig kvalifisert URL-adresse til den instruktørledede kursdetaljsiden i Microsoft Learn på den forespurte nasjonale innstillingen. |
icon_url |
string | En fullstendig kvalifisert URL-adresse til et 100x100 SVG-bilde som representerer den instruktørledede kursprestasjonen. |
locales |
matrise med strenger | En liste over språk dette instruktørledede kurset tilbys offisielt på. Andre språk kan støttes av læringspartnere. |
type |
string | Posttypen. Verdien vil alltid være «kurs» for instruktørledede kurs. |
certification |
string | Sertifisering knyttet til det instruktørledede kurset. |
exam |
string | Eksamen knyttet til det instruktørledede kurset. |
levels |
matrise med strenger | En liste over nivåene knyttet til dette instruktørledede kurset, som indikerer hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter ved dette kurset. Detaljer om enhetene kan refereres til i nivåoppføringene. |
study_guide |
matrise over objekter | En fullstendig kvalifisert URL-adresse til PDF-en som beskriver ferdighetene som måles av denne sertifiseringen. |
Nivå-, produkt-, rolle- og emneoppføringer
Samlingene levels, products, roles, og subjects gir egendefinerte navn for verdiene som brukes i modul- og læreprogramdataene. Alle fire samlinger har samme form:
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
id vil samsvare med verdiene for nivåer, produkter, roller og emner som er inkludert i de andre katalogoppføringene. Tilknyttede name angir et egennavn på engelsk for oppføringen. Matrisen children er valgfri og muliggjør et hierarki for verdier som har underordnede relasjoner, for eksempel produkter.
Som et eksempel, her er et sett med mulige roller:
{
...
"roles": [
{
"id": "administrator",
"name": "Administrator"
},
{
"id": "ai-engineer",
"name": "AI Engineer"
},
{
"id": "business-analyst",
"name": "Business Analyst"
},
{
"id": "developer",
"name": "Developer"
},
...
]
}
Her er et eksempelsett med produkter, med underordnede elementer som angir en mer spesifikk produktkategori.
{
...
"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"
},
...
]
}
Kodeeksempler
Det er mange måter å anrope Learn Catalog API, men kodeeksemplene nedenfor er eksempler på hvordan det kan brukes.
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 ved hjelp av cURL-utvidelse
<?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 bruker «forepørsler»-biblioteket
#!/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)
Neste trinn
Se gjennom ressursene nedenfor for å hjelpe deg med utviklingsreisen: