Referansedokumentasjon for Microsoft Learn Catalog API-utviklere
Denne artikkelen inneholder informasjon for utviklere og anmodere som implementerer Katalog-API for Microsoft Learn. Vi anbefaler også at du sjekker ut Learn Catalog API anbefalte fremgangsmåter, produktmerknaderog vanlige spørsmål artikler for å støtte utviklingsreisen.
API-endepunkt
Katalog-API-en for Microsoft Learn - er en REST-basert web-API som returnerer et JSON-kodet svar. Hvis du vil be om hele katalogen, sender du en GET-forespørsel til:
https://learn.microsoft.com/api/catalog/
Notat
Endepunktet som er oppført ovenfor, er gjeldende endepunkt. Hvis du bruker et annet, eldre endepunkt, vil det fortsatt fungere som forventet når du er om bord, men fordelene ved å bytte til det nye endepunktet er at det vil gi deg forbedrede funksjoner, for eksempel flere spørringsparametere.
Spørringsparametere
Følgende er spørringsparameterne 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, vurderes spørringen ved hjelp av AND-operatoren.
| Navn | Verdi | Type | Påkrevd | Eksempel |
|---|---|---|---|---|
| Nasjonal innstilling | En enkel, gyldig nasjonal innstillingskode fra listen over støttede nasjonale innstillinger. De returnerte metadataene vil være i den forespurte nasjonale innstillingen hvis tilgjengelig. Hvis denne parameteren ikke er angitt, returneres en-us svar. |
streng | Nei | ?locale=en-us |
| type | En kommadelt liste over ett eller flere av de øverste innholds- eller taksonomiobjektene vi for øyeblikket oppgir i svaret for å returnere. Støttede verdier er: modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, courses, levels, roles, products, subjects. |
streng | Nei | ?type=modules,learningPaths |
| Uid | En kommadelt liste over én eller flere gyldige unike innholds-ID-er (uid) fra de tilgjengelige innholdstypene. Obs! UID-er skiller mellom store og små bokstaver. | streng | Nei | ?uid=learn.azure.intro-to-azure-fundamentals |
| last_modified | En operator og datetime for å filtrere etter siste endringsdato for objekter. Operatoren 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 operatoren som standard gte hvis den ikke er angitt. |
streng | Nei | ?last_modified=gte 2022-01-01 |
| popularitet | En operator og verdi for å filtrere etter popularitetsverdien (i et område på 0-1) av objekter. Operatoren 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 operatoren som standard gte hvis den ikke er angitt. |
streng | Nei | ?popularity=gte 0.5 |
| nivå | En kommadelt liste over ett eller flere av nivåene vi har tilgjengelig for øyeblikket (fullstendig liste er på nivåer objekt for API-svaret). | streng | Nei | ?level=beginner |
| rolle | En kommadelt liste over én eller flere av rollene vi har for øyeblikket (fullstendig liste er i roller objekt for API-svaret). | streng | Nei | ?role=developer |
| produkt | En kommadelt liste over én eller flere av rollene vi har for øyeblikket (fullstendig liste er i produkter objekt for API-svaret). API-en støtter ikke produkthierarki, så legg til hvert produkt i listen du vil inkludere i spørringen. | streng | Nei | ?product=azure |
| tema | En kommadelt liste over én eller flere av rollene vi har for øyeblikket (fullstendig liste er i emner objekt for API-svaret). API-en støtter ikke emnehierarki, så legg til alle emnene i listen du vil inkludere i spørringen. | streng | Nei | ?subject=cloud-computing |
Eksempelspørringer
Spørringene nedenfor er eksempler som hjelper deg med å få en følelse av hva du kan be om, og hvordan du danner forespørselen.
| Beskrivelse | Spørsmål |
|---|---|
| Alle elementer i learn-katalog-API-en | https://learn.microsoft.com/api/catalog/ |
| Alle spanske moduler | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| Alle moduler med en popularitetspoengsum på 0,9 eller høyere | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Alle nybegynnere sikkerhetsopplæring og sertifiseringsobjekter | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Alle avanserte tilgjengelighetsmoduler med en popularitetspoengsum over 0,5 og oppdatert i 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 | Beskrivelse |
|---|---|
| 200 | Suksess. Brødteksten i svaret inkluderer JSON-kodede data. |
| 400 | Én av spørringsparameterne mangler eller er ugyldig. |
| 404 | Finner ikke URL-adressen på serveren. |
| 500 | Uventet serverfeil. |
| 503 | Tjenesten er midlertidig utilgjengelig. |
Et vellykket svar inkluderer detaljer 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: er en matrise med publiserte moduler. -
units: er en matrise med publiserte enheter. -
learningPaths: er en rekke 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 matrise med publiserte sertifiseringer. -
exams: er en matrise med publiserte eksamener. -
courses: er en rekke publiserte instruktørledede opplæringskurs. -
levels: er en matrise med mulige målgruppenivåer. -
products: er en matrise med mulige produkter og tjenester som dekkes i katalogen. -
roles: er en matrise med mulige jobbroller. -
subjects: er en matrise med mulige emnekoder.
Modulposter
Modulposter
Hver modulpost har følgende skjema:
{
"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 | Beskrivelse |
|---|---|---|
summary |
streng | 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 som er knyttet til denne modulen, som angir hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter av denne modulen. Detaljer om enhetene kan refereres til i nivåpostene. |
roles |
matrise med strenger | En liste over jobbrollene som denne modulen er relevant for. |
products |
matrise med strenger | En liste over relevante produkter denne modulen dekker. Detaljer om produktene kan refereres til i produktpostene. |
subjects |
matrise med strenger | En liste over relevante emner som dette læreprogrammet dekker. |
uid |
streng | En unik identifikator for denne modulen – denne verdien vil være unik på tvers av hele MS Learn. |
type |
streng | Oppføringstypen. Verdien vil alltid være «modul». |
title |
streng | Tittelen på modulen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
duration_in_minutes |
heltall | Gjennomsnittstiden denne modulen tar å fullføre i minutter. |
rating |
objekt | Inneholder både count, som er antall personer som har vurdert modulen, og average, et aggregat av vurderingene, som vil være 1-5 |
popularity |
dobbel | En normalisert verdi fra 0-1 som angir populariteten til modulen |
icon_url |
streng | En fullstendig url-adresse til et SVG-bilde på 100 x 100 som representerer bildet av modulen med gjennomsiktig bakgrunn. |
social_image_url |
streng | En fullstendig url-adresse til et PNG-bilde som representerer bildet av modulen 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 |
streng | Språket som disse JSON-dataene er skrevet i. Denne verdien vil være den forespurte nasjonale innstillingen hvis den er tilgjengelig, eller «en-us» hvis ikke. |
last_modified |
daddel | Sist gang denne modulen hadde en stor revisjon. |
url |
streng | En fullstendig url-adresse til Learn-modulen i den forespurte nasjonale innstillingen. |
firstUnitUrl |
streng | En fullstendig url-adresse til den første enheten i Learn-modulen i den forespurte nasjonale innstillingen. |
units |
matrise med strenger | En liste over de tilknyttede enhetsgrensesnittene. Detaljer om enhetene kan refereres til i enhetspostene. |
number_of_children |
heltall | Antall sider (enheter) denne modulen har i seg. |
Enhetsposter
Hver enhetspost har følgende skjema:
{
"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"
},
Notat
Enhetsposten har ikke den tilknyttede URL-adressen fordi enheter ikke er skrevet som frittstående innhold. De er ment å tas i en bestemt rekkefølge for modulen. Derfor inkluderer vi koblingen til moduldetaljsiden og den første enheten i modulposten, slik at brukerne kan starte der og fortsette gjennom innholdet. Enhetspostene kan imidlertid brukes til å få detaljer om enhetene som skal vises i LMSes eller andre opplevelser.
Feltdetaljer
| Felt | Type | Beskrivelse |
|---|---|---|
uid |
streng | En unik identifikator for denne modulen – denne verdien vil være unik på tvers av hele MS Learn. |
type |
streng | Oppføringstypen. Verdien vil alltid være "enhet". |
title |
streng | Tittelen på enheten i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
duration_in_minutes |
Varigheten for enheten. Hvis du legger til alle duration_in_minutes av enhetene som er knyttet til hver modul, får du total modultid. | |
locale |
streng | Språket som disse JSON-dataene er skrevet i. Denne verdien vil være den forespurte nasjonale innstillingen hvis den er tilgjengelig, eller «en-us» hvis ikke. |
last_modified |
daddel | Sist gang denne modulen hadde en stor revisjon. |
Læreprogramoppføringer
Hver læringsbaneoppføring har følgende skjema:
{
"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 | Beskrivelse |
|---|---|---|
summary |
streng | 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 som er knyttet til dette læreprogrammet, som angir hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter av dette læreprogrammet. Detaljer om enhetene kan refereres til i nivåpostene. |
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 produktpostene. |
subjects |
matrise med strenger | En liste over relevante emner som dette læreprogrammet dekker. |
uid |
streng | En unik identifikator for dette læreprogrammet – denne verdien vil være unik på tvers av hele MS Learn. |
type |
streng | Oppføringstypen. Verdien vil alltid være learningPath. |
title |
streng | Tittelen på læreprogrammet i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
duration_in_minutes |
heltall | Den gjennomsnittlige tiden dette læreprogrammet tar å fullføre i løpet av minutter. Denne verdien er en sum av data fra alle modulene som er inkludert. |
rating |
objekt | Inneholder både count, som er antall personer som har vurdert læringsbanen, og average, et aggregat av vurderingene, som vil være 1-5 |
popularity |
dobbel | En normalisert verdi fra 0-1 som indikerer populariteten til læringsbanen |
icon_url |
streng | En fullstendig url-adresse til et 100x100 SVG-bilde som representerer læreprogrammet. |
social_image_url |
streng | En fullstendig url-adresse til et PNG-bilde som representerer prestasjonsbildet for læringsbanen 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 |
streng | Språket som disse JSON-dataene er skrevet i. Denne verdien vil være den forespurte nasjonale innstillingen hvis den er tilgjengelig, eller «en-us» hvis ikke. |
last_modified |
daddel | Sist gang dette læreprogrammet ble endret. |
url |
streng | En fullstendig url-adresse til læreprogrammet i Microsoft Learn i den forespurte nasjonale innstillingen. |
firstModuleUrl |
streng | En fullstendig url-adresse til den første modulen av læreprogrammet i Microsoft Learn i den forespurte nasjonale innstillingen. |
modules |
matrise med strenger | En liste over de tilknyttede modulgrensesnittene. Detaljer om modulene kan refereres til i modulpostene. |
number_of_children |
heltall | Antall moduler dette læreprogrammet har i seg. |
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 | Beskrivelse |
|---|---|---|
uid |
streng | En unik identifikator for denne brukte kompetansen – denne verdien vil være unik på tvers av hele MS Learn. |
locale |
streng | Språket som disse JSON-dataene er skrevet i. Denne verdien vil være den forespurte nasjonale innstillingen hvis den er tilgjengelig, eller «en-us» hvis ikke. |
title |
streng | Tittelen på anvendt kompetanse i den angitte nasjonale innstillingen, eller amerikansk engelsk som en tilbakefall. |
summary |
streng | Sammendraget for anvendt kompetanse i den angitte nasjonale innstillingen, eller amerikansk engelsk som en tilbakefall. |
url |
streng | En fullstendig url-adresse til anvendt kompetanse i Microsoft Learn i den forespurte nasjonale innstillingen. |
icon_url |
streng | 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 rollepostene. |
subjects |
matrise med strenger | En liste over relevante emner denne anvendte kompetansen dekker. |
study_guide |
matrise med objekter | En liste over det tilknyttede innholdet som skal studeres for denne anvendte kompetansen. Detaljer om objektene kan refereres til i tilknyttede poster. |
last_modified |
daddel | 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 | Beskrivelse |
|---|---|---|
uid |
streng | En unik identifikator for denne sertifiseringen – denne verdien vil være unik på tvers av hele MS Learn. |
title |
streng | Tittelen på sertifiseringen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
summary |
streng | Sammendraget for sertifiseringen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
url |
streng | En fullstendig url-adresse til sertifiseringen i Microsoft Learn i den forespurte nasjonale innstillingen. |
icon_url |
streng | En fullstendig url-adresse til et 100x100 SVG-bilde som representerer sertifiseringen. |
last_modified |
daddel | Siste gang denne sertifiseringen ble endret. |
type |
streng | Oppføringstypen. Verdien vil alltid være "cert". |
certification_type |
streng | Sertifiseringstypen. De mulige verdiene er "grunnleggende", "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 produktpostene. |
levels |
matrise med strenger | En liste over nivåene som er knyttet til denne sertifiseringen, som angir 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åpostene. |
roles |
matrise med strenger | En liste over de relevante jobbrollene for denne sertifiseringen. Detaljer om rollene kan refereres til i rollepostene. |
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 med objekter | En liste over det tilknyttede innholdet som skal studeres for denne sertifiseringen. Detaljer om objektene kan refereres til i tilknyttede poster. |
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 med objekter | En liste over leverandører for denne sertifiseringen. Typen beskriver hvilken leverandør og en fullstendig url-adresse med en kobling til å planlegge en eksamen med leverandøren. |
career_paths |
matrise med objekter | En liste over karriereveier for denne sertifiseringen. |
Notat
Sertifiseringer som bare krever én eksamen, returneres som en del av denne mergedCertifications-egenskapen.
Sertifiseringsposter
Hver sertifiseringspost har følgende skjema:
{
"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 | Beskrivelse |
|---|---|---|
uid |
streng | En unik identifikator for denne sertifiseringen – denne verdien vil være unik på tvers av hele MS Learn. |
title |
streng | Tittelen på sertifiseringen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
subtitle |
streng | Undertittelen for sertifiseringen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som en tilbakefall. |
url |
streng | En fullstendig url-adresse til sertifiseringen i Microsoft Learn i den forespurte nasjonale innstillingen. |
icon_url |
streng | En fullstendig url-adresse til et 100x100 SVG-bilde som representerer sertifiseringen. |
type |
streng | Oppføringstypen. Verdien vil alltid være "cert". |
certification_type |
streng | Sertifiseringstypen. De mulige verdiene er "grunnleggende", "mce", "mcsa", "mcsd", "mcse", "mos", "mta", "rollebasert", "spesialitet". |
exams |
matrise med strenger | En liste over de tilknyttede eksamenene som kreves for denne sertifiseringen. Detaljer om enhetene kan refereres til i sertifiseringspostene. |
levels |
matrise med strenger | En liste over nivåene som er knyttet til denne sertifiseringen, som angir 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åpostene. |
roles |
matrise med strenger | En liste over de relevante jobbrollene for denne sertifiseringen. Detaljer om rollene kan refereres til i rollepostene. |
study_guide |
matrise med objekter | En liste over det tilknyttede innholdet som skal studeres for denne sertifiseringen. Detaljer om objektene kan refereres til i tilknyttede poster. |
Notat
Sertifiseringer som krever mer enn én eksamen, vil være til stede i denne sertifiseringsposten som refererer til eksamensmatrisen.
Eksamensposter
Hver eksamensoppføring har følgende skjema:
{
"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 | Beskrivelse |
|---|---|---|
uid |
streng | En unik identifikator for denne eksamenen – denne verdien vil være unik på tvers av hele MS Learn. |
title |
streng | Tittelen for eksamen i den nasjonale innstillingen forespurt, eller amerikansk engelsk som en tilbakefall. |
subtitle |
streng | Undertittelen for eksamen i den nasjonale innstillingen forespurt, eller amerikansk engelsk som en tilbakefall. |
display_name |
streng | Visningsnavnet for eksamen i den forespurte nasjonale innstillingen, eller amerikansk engelsk som et tilbakefall. |
url |
streng | En fullstendig url-adresse til eksamen i Microsoft Learn i den forespurte nasjonale innstillingen. |
icon_url |
streng | En fullstendig url-adresse til et 100x100 SVG-bilde som representerer eksamen. |
pdf_download_url |
streng | En fullstendig url-adresse til PDF-filen som beskriver ferdighetene som måles av denne eksamenen. |
practice_test_url |
streng | En fullstendig url-adresse til en øvelsestest som er knyttet til eksamen. |
practice_assessment_url |
streng | En fullstendig nettadresse til en gratis praksisvurdering knyttet til eksamen. |
locales |
matrise med strenger | En liste over språk denne eksamenen tilbys i. |
type |
streng | Oppføringstypen. Verdien vil alltid være eksamen. |
courses |
matrise med strenger | En liste over de tilknyttede kursgrensesnittene. Det kan refereres til detaljer om kursene i kurspostene. |
levels |
matrise med strenger | En liste over nivåene som er knyttet til denne eksamenen, som angir hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter av denne eksamenen. Detaljer om enhetene kan refereres til i nivåpostene. |
roles |
matrise med strenger | En liste over de relevante jobbrollene for denne eksamenen. Detaljer om rollene kan refereres til i rollepostene. |
products |
matrise med strenger | En liste over relevante produkter denne eksamenen dekker. Detaljer om produktene kan refereres til i produktpostene. |
providers |
matrise med objekter | En liste over leverandører for denne eksamenen. Typen beskriver hvilken leverandør og en fullstendig url-adresse med en kobling til å planlegge en eksamen med leverandøren. |
study_guide |
matrise med objekter | En liste over det tilknyttede innholdet som skal studeres for denne eksamenen. Detaljer om objektene kan refereres til i tilknyttede poster. |
Kursoppføringer ledet av instruktør
Hver kursoppføring har følgende skjema:
{
"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 | Beskrivelse |
|---|---|---|
uid |
streng | En unik identifikator for dette instruktørledede kurset – denne verdien vil være unik på tvers av hele MS Learn. |
course_number |
streng | Den instruktørledede kursnummeridentifikatoren. |
title |
streng | Tittelen på det instruktørledede kurset i den nasjonale innstillingen forespurt, eller amerikansk engelsk som en tilbakefall. |
summary |
streng | En streng som gir en kort beskrivelse av instruktørledet. Verdien uttrykkes som en HTML-avsnittskode der den indre teksten er sammendraget. |
duration_in_hours |
heltall | Den gjennomsnittlige tiden dette instruktørledede kurset tar å fullføre i timer. |
url |
streng | En fullstendig url-adresse til den instruktørledede kursdetaljsiden i Microsoft Learn i den forespurte nasjonale innstillingen. |
icon_url |
streng | En fullstendig 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 i. Andre språk kan støttes av læringspartnere. |
type |
streng | Oppføringstypen. Verdien vil alltid være "kurs" for instruktørledede kurs. |
certification |
streng | Sertifisering knyttet til det instruktørledede kurset. |
exam |
streng | Eksamen knyttet til det instruktørledede kurset. |
levels |
matrise med strenger | En liste over nivåene som er knyttet til dette instruktørledede kurset, som angir hvor mye erfaring i rollen som er nødvendig for å forstå alle aspekter av dette kurset. Detaljer om enhetene kan refereres til i nivåpostene. |
study_guide |
matrise med objekter | En fullstendig url-adresse til PDF-filen som beskriver ferdighetene som måles av denne sertifiseringen. |
Nivå-, produkt-, rolle- og emneoppføringer
Samlingene levels, products, rolesog subjects gir egendefinerte navn for verdiene som brukes i modul- og læringsbanedataene. Alle fire samlingene har samme figur:
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
Den id samsvarer med verdiene for nivåer, produkter, roller og emner som er inkludert i de andre katalogoppføringene. Den tilknyttede name gir et riktig navn på engelsk for oppføringen. Den children matrisen er valgfri og aktiverer hierarkisk for verdier som har underordnede relasjoner, for eksempel produkter.
Her er for eksempel 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 barn inkludert for å gi 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 finnes mange måter å kalle learn-katalog-API-en på, men kodeeksemplet nedenfor er eksempler på hvordan den 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 ved hjelp av «forespørsler»-bibliotek
#!/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:
- anbefalte fremgangsmåter for Learn Catalog API
- Lære katalog-API vanlige spørsmål
- produktmerknader for Learn Catalog API