Dokumentation til udviklerreference til Microsoft Learn Catalog API
Denne artikel indeholder oplysninger til udviklere og anmodere, der implementerer Microsoft Learn Catalog-API'en. Vi anbefaler også, at du tjekker de bedste fremgangsmåder for Learn Catalog-API'en, produktbemærkninger og ofte stillede spørgsmål ud for at understøtte din udviklingsrejse.
API-slutpunkt
Microsoft Learn Catalog-API'en er en REST-baseret web-API, der returnerer et JSON-kodet svar. Send en GET-anmodning for at anmode om det fulde katalog:
https://learn.microsoft.com/api/catalog/
Bemærk
Det slutpunkt, der er angivet ovenfor, er det aktuelle slutpunkt. Det gamle slutpunkt fungerer stadig som forventet, men fordelene ved at skifte til det nye slutpunkt er, at det giver dig forbedrede funktioner, f.eks. yderligere forespørgselsparametre.
Forespørgselsparametre
Det følgende er de forespørgselsparametre, som anmodningen kan indeholde. Alle er valgfrie. Du skal angive en URL-kode for forespørgselsparameterværdierne. Du kan bruge slutpunktet uden nogen, én, nogle eller alle disse parametre.
Vigtigt
Hvis du bruger mere end én, evalueres forespørgslen ved hjælp af operatøren AND.
| Name | Værdi | Type | Påkrævet | Eksempel |
|---|---|---|---|---|
| landestandard | En enkelt gyldig landekode fra den understøttede liste over landestandarder. De returnerede metadata vil være i den ønskede landestandard, hvis de er tilgængelige. Hvis denne parameter ikke angives, en-us returneres svaret. |
string | Nej | ?locale=en-us |
| type | En kommasepareret liste over et eller flere af de indholds- eller taksonomiobjekter på øverste niveau, som vi i øjeblikket leverer som svar på returnering. Understøttede værdier er: modules, units, learningPaths, appliedSkills, certifications, mergedCertificationsexams, courseslevels, roles, , productssubjects. |
string | Nej | ?type=modules,learningPaths |
| uid | En kommasepareret liste over et eller flere gyldige unikke id'er (uid) for indhold fra de tilgængelige indholdstyper. Bemærk: Der skelnes mellem store og små bogstaver i uid'er. | string | Nej | ?uid=learn.azure.intro-to-azure-fundamentals |
| senest_ændret | En operatør og dato/tid til at filtrere efter den senest ændrede dato for objekter. Operatoren indeholder lt (mindre end), lte (mindre end eller lig med), eq (lig med), gt (større end), gte (større end eller lig med). Når du bruger denne parameter, vil operatoren som standard være gte, hvis den ikke er angivet. |
string | Nej | ?last_modified=gte 2022-01-01 |
| popularitet | En operatør og værdi, der skal filtreres efter popularitetsværdien (i et interval på 0-1) af objekter. Operatoren indeholder lt (mindre end), lte (mindre end eller lig med), eq (lig med), gt (større end), gte (større end eller lig med). Når du bruger denne parameter, vil operatoren som standard være gte, hvis den ikke er angivet. |
string | Nej | ?popularity=gte 0.5 |
| niveau | En kommasepareret liste over et eller flere af de niveauer, vi i øjeblikket har tilgængelige (fuld liste findes i objektet niveauer i API-responsen). | string | Nej | ?level=beginner |
| rolle | En kommasepareret liste over et eller flere af de roller, vi i øjeblikket har tilgængelige (fuld liste findes i objektet roller i API-responsen). | string | Nej | ?role=developer |
| Produkt | En kommasepareret liste over et eller flere af de roller, vi i øjeblikket har tilgængelige (fuld liste findes i objektet produkter i API-responsen). API'en understøtter ikke produkthierarkiet, så føj alle produkter til den liste, du vil medtage i din forespørgsel. | string | Nej | ?product=azure |
| emne | En kommasepareret liste over en eller flere af de roller, vi i øjeblikket har tilgængelige (fuld liste findes i emnernes objekt i API-responsen). API'en understøtter ikke emnehierarki, så føj alle emner til den liste, du vil medtage i din forespørgsel. | string | Nej | ?subject=cloud-computing |
Eksempelforespørgsler
De forespørgsler, der er angivet nedenfor, er eksempler, der hjælper dig med at få en fornemmelse af, hvad du kan anmode om, og hvordan du opretter anmodningen.
| Description | Anmodning |
|---|---|
| Alle elementer i Learn Catalog-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 popularitetsscore på 0,9 eller højere | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Alle sikkerhedstrænings- og certificeringsobjekter for begyndere | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Alle avancerede tilgængelighedsmoduler med en popularitetsscore på over 0,5 og opdateret i den sidste måned | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
API-respons
Tjenesten returnerer muligvis følgende HTTP-statuskoder.
| Statuskode | Description |
|---|---|
| 200 | Vellykket. Brødteksten i svaret indeholder de JSON-kodede data. |
| 400 | En af forespørgselsparametrene mangler eller er ikke gyldig. |
| 404 | URL-adressen blev ikke fundet på serveren. |
| 500 | Uventet serverfejl. |
| 503 | Tjenesten er ikke tilgængelig i øjeblikket. |
Et vellykket svar indeholder oplysninger om alle moduler og læringsforløb, som vist nedenfor.
Brødtekst i svar
En vellykket svartekst kodes i JSON og har 12 afsnit:
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
Hvert matrix indeholder et eller flere JSON-kodede objekter, der indeholder data, som er specifikke for det pågældende afsnit i svaret.
modules: er en matrix af publicerede moduler.units: Er en matrix af publicerede enheder.learningPaths: er en matrix af publicerede læringsforløb.appliedSkills: er en matrix af publicerede anvendte færdigheder.mergedCertifications: er en matrix af publicerede certificeringer, der er flettet med eksamener.certifications: Er en matrix af publicerede certificeringer.exams: Er en matrix af publicerede eksamener.courses: Er en matrix af publicerede instruktørledede træningskurser.levels: er en matrix af mulige målgruppeniveauer.products: Er en matrix af mulige produkter og tjenester, der er dækket i kataloget.roles: er en matrix af mulige jobroller.subjects: Er en matrix af mulige emnetags.
Modulposter
Modulposter
Alle modulposter har 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
}
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
summary |
string | En streng, der indeholder en kort beskrivelse af modulet. Værdien angives som en HTML-afsnitskode, hvor den indre tekst er resuméet. |
levels |
matrix af strenge | En liste over de niveauer, der er knyttet til dette modul, som angiver, hvor meget erfaring i rollen der er nødvendig for at forstå alle aspekter af dette modul. Der kan refereres til oplysninger om enhederne i niveauposterne. |
roles |
matrix af strenge | En liste over de jobroller, som dette modul er relevant for. |
products |
matrix af strenge | En liste over relevante produkter, som er omfattet af dette modul. Der kan refereres til oplysninger om produkterne i produktposterne. |
subjects |
matrix af strenge | En liste over relevante emner, som er omfattet af dette læringsforløb. |
uid |
string | Et entydigt id for dette modul – denne værdi vil være entydig på tværs af hele MS Learn. |
type |
string | Posttypen. Værdien vil altid være 'modul'. |
title |
string | Titlen på modulet i den angivne landestandard eller amerikansk engelsk som reserve. |
duration_in_minutes |
integer | Den gennemsnitlige tid, det tager at fuldføre dette modul, i minutter. |
rating |
objekt | Det indeholder både count, som er antallet af personer, der har bedømt modulet, og average, der er en samling af bedømmelserne, som vil være 1-5 |
popularity |
dobbelt | En normaliseret værdi fra 0-1, der angiver modulets popularitet |
icon_url |
string | En fuldt kvalificeret URL-adresse til et SVG-billede på 100 x 100, der repræsenterer billedet af modulets præstation med en gennemsigtig baggrund. |
social_image_url |
string | En fuldt kvalificeret URL-adresse til et PNG-billede, der repræsenterer modulets præstationsbillede med en rektangulær uigennemsigtig baggrund, der er velegnet til sociale medier eller deloplevelser. Hvis den ikke er tilgængelig for dette modul, returneres denne egenskab ikke i svaret. |
locale |
string | Det sprog, som disse JSON-data er skrevet i. Denne værdi vil være den ønskede landestandard, hvis den er tilgængelig, eller 'en-us', hvis det ikke er muligt. |
last_modified |
dato | Sidste gang, der blev foretaget en større ændring af dette modul. |
url |
string | En fuldt gyldig URL-adresse til modulet i Microsoft Learn i den ønskede landestandard. |
firstUnitUrl |
string | En fuldt kvalificeret URL-adresse til modulets første undermodul i den ønskede landestandard. |
units |
matrix af strenge | En liste over de tilknyttede enheds-UID'er. Der kan refereres til oplysninger om enhederne i enhedsposterne. |
number_of_children |
integer | Antallet af sider (enheder) i det pågældende modul. |
Enhedsposter
Alle enhedsposter har 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"
},
Bemærk
Enhedsposten har ikke den tilknyttede URL-adresse, fordi enheder ikke skrives som enkeltstående indhold. De er beregnet til at blive taget i en bestemt rækkefølge for modulet. Derfor inkluderer vi linket til siden med moduloplysninger og den første enhed i modulposten, så brugerne kan starte der og fortsætte gennem indholdet. Enhedsposterne kan dog bruges til at få oplysninger om de enheder, der skal vises i LMSes eller andre oplevelser.
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
uid |
string | Et entydigt id for dette modul – denne værdi vil være entydig på tværs af hele MS Learn. |
type |
string | Posttypen. Værdien vil altid være 'enhed'. |
title |
string | Titlen på enheden i den angivne landestandard eller amerikansk engelsk som reserve. |
duration_in_minutes |
Enhedens varighed. Hvis du tilføjer alle duration_in_minutes af de enheder, der er knyttet til hvert modul, får du den samlede modultid. | |
locale |
string | Det sprog, som disse JSON-data er skrevet i. Denne værdi vil være den ønskede landestandard, hvis den er tilgængelig, eller 'en-us', hvis det ikke er muligt. |
last_modified |
dato | Sidste gang, der blev foretaget en større ændring af dette modul. |
Læringsforløbsposter
Alle læringsforløb har 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
}
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
summary |
string | En streng, der indeholder en kort beskrivelse af læringsforløbet. Værdien angives som en HTML-afsnitskode, hvor den indre tekst er resuméet. |
levels |
matrix af strenge | En liste over de niveauer, der er knyttet til dette læringsforløb, som angiver, hvor meget erfaring i rollen der er nødvendig for at forstå alle aspekter af dette modul. Der kan refereres til oplysninger om enhederne i niveauposterne. |
roles |
matrix af strenge | En liste over de relevante job roller for dette læringsforløb. |
products |
matrix af strenge | En liste over relevante produkter, som er omfattet af dette læringsforløb. Der kan refereres til oplysninger om produkterne i produktposterne. |
subjects |
matrix af strenge | En liste over relevante emner, som er omfattet af dette læringsforløb. |
uid |
string | Et entydigt id for dette læringsforløb – denne værdi vil være entydig på tværs af hele MS Learn. |
type |
string | Posttypen. Værdien vil altid være 'læringsforløb'. |
title |
string | Titlen på læringsforløbet i den angivne landestandard eller amerikansk engelsk som reserve. |
duration_in_minutes |
integer | Den gennemsnitlige tid, det tager at fuldføre dette læringsforløb, i minutter. Denne værdi er en sum af data fra alle de inkluderede moduler. |
rating |
objekt | Det indeholder både count, som er antallet af personer, der har bedømt læringsforløbet, og average, der er en samling af bedømmelserne, som vil være 1-5 |
popularity |
dobbelt | En normaliseret værdi fra 0-1, der angiver læringsforløbets popularitet |
icon_url |
string | En fuldt kvalificeret URL-adresse til et billede i formatet 100x100 SVG, der repræsenterer læringsforløbet. |
social_image_url |
string | En fuldt kvalificeret URL-adresse til et PNG-billede, der repræsenterer læringsforløbets præstationsbillede med en rektangulær uigennemsigtig baggrund, der er velegnet til sociale medier eller deloplevelser. Hvis den ikke er tilgængelig for dette modul, returneres denne egenskab ikke i svaret. |
locale |
string | Det sprog, som disse JSON-data er skrevet i. Denne værdi vil være den ønskede landestandard, hvis den er tilgængelig, eller 'en-us', hvis det ikke er muligt. |
last_modified |
dato | Sidste gang, der blev foretaget en ændring af dette læringsforløb. |
url |
string | En fuldt gyldig URL-adresse til læringsforløbet i Microsoft Learn i den ønskede landestandard. |
firstModuleUrl |
string | En fuldt gyldig URL-adresse til læringsforløbets første modul i Microsoft Learn i den ønskede landestandard. |
modules |
matrix af strenge | En liste over de tilknyttede modul-UID'er. Der kan refereres til oplysninger om modulerne i modulposterne. |
number_of_children |
integer | Det antal moduler, dette læringsforløb indeholder. |
Poster for anvendte færdigheder
Hver post af typen Anvendte færdigheder har følgende formular:
{
"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"
}
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
uid |
string | Et entydigt id for denne anvendte færdighed – denne værdi vil være entydig på tværs af hele MS Learn. |
locale |
string | Det sprog, som disse JSON-data er skrevet i. Denne værdi vil være den ønskede landestandard, hvis den er tilgængelig, eller 'en-us', hvis det ikke er muligt. |
title |
string | Titlen på den anvendte færdighed i den ønskede landestandard eller amerikansk engelsk som reserve. |
summary |
string | Oversigten over anvendte færdigheder i den ønskede landestandard eller amerikansk engelsk som reserve. |
url |
string | En fuldt kvalificeret URL-adresse til den anvendte færdighed i Microsoft Learn i den ønskede landestandard. |
icon_url |
string | En fuldt kvalificeret URL-adresse til et 100x100 SVG-billede, der repræsenterer Anvendt færdighed (når den er tilgængelig, ellers ikke inkluderet). |
levels |
matrix af strenge | En liste over de niveauer, der er knyttet til denne anvendte færdighed. |
roles |
matrix af strenge | En liste over de relevante jobroller for denne anvendte færdighed. Der kan refereres til oplysninger om rollerne i rolleposterne. |
subjects |
matrix af strenge | En liste over relevante emner, som denne anvendte færdighed dækker. |
study_guide |
matrix af objekter | En liste over det tilknyttede indhold, der skal undersøges for denne anvendte færdighed. Der kan refereres til oplysninger om objekterne i deres tilknyttede poster. |
last_modified |
dato | Sidste gang denne anvendte færdighed blev ændret. |
Flettede certificeringsposter
Hver flettet certificeringspost har følgende formular:
{
"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": []
}
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
uid |
string | Et entydigt id for denne certificering – denne værdi vil være entydig på tværs af hele MS Learn. |
title |
string | Titlen på certificeringen i den angivne landestandard eller amerikansk engelsk som reserve. |
summary |
string | Oversigten over certificeringen i den ønskede landestandard eller amerikansk engelsk som reserve. |
url |
string | En fuldt gyldig URL-adresse til certificeringen i Microsoft Learn i den ønskede landestandard. |
icon_url |
string | En fuldt kvalificeret URL-adresse til et billede i formatet 100x100 SVG, der repræsenterer certificeringen. |
last_modified |
dato | Sidste gang denne certificering blev ændret. |
type |
string | Posttypen. Værdien vil altid være 'cert'. |
certification_type |
string | Certificeringstypen. De mulige værdier er 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
products |
matrix af strenge | En liste over relevante produkter, som denne certificering dækker. Der kan refereres til oplysninger om produkterne i produktposterne. |
levels |
matrix af strenge | En liste over de niveauer, der er knyttet til denne certificering, som angiver, hvor meget erfaring i rollen der er nødvendig for at forstå alle aspekter af denne certificering. Der kan refereres til oplysninger om enhederne i niveauposterne. |
roles |
matrix af strenge | En liste over de relevante jobroller for denne certificering. Der kan refereres til oplysninger om rollerne i rolleposterne. |
subjects |
matrix af strenge | En liste over relevante emner, som denne certificering dækker. |
renewal_frequency_in_days |
integer | Antallet af dage, før denne certificering udløber og skal fornys. Hvis værdien er 0, udløber certificeringen ikke. |
prerequisites |
matrix af strenge | En liste over de anbefalede forudsætninger for at opnå denne certificering. Der kan refereres til oplysninger om certificeringerne i certificeringsposterne. |
skills |
matrix af strenge | En liste over de færdigheder, der måles på den eksamen, der kræves til denne certificering. |
recommendation_list |
matrix af strenge | En liste over de anbefalede i forbindelse med denne certificering. |
study_guide |
matrix af objekter | En liste over det tilknyttede indhold, der skal undersøges for denne certificering. Der kan refereres til oplysninger om objekterne i deres tilknyttede poster. |
exam_duration_in_minutes |
integer | Det antal minutter, der er afsat til at gennemføre eksamen. |
locales |
matrix af strenge | En liste over de sprog, som denne certificering tilbydes på. |
providers |
matrix af objekter | En liste over udbydere af denne certificering. Typen beskriver, hvilken udbyder og en fuldt kvalificeret URL-adresse med et link til at planlægge en eksamen med udbyderen. |
career_paths |
matrix af objekter | En liste over karriereforløb for denne certificering. |
Bemærk
Certificeringer, der kun kræver én eksamen, returneres som en del af denne flettede egenskabCertifications.
Certificeringsposter
Alle certificeringsposter har 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"
}
]
}
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
uid |
string | Et entydigt id for denne certificering – denne værdi vil være entydig på tværs af hele MS Learn. |
title |
string | Titlen på certificeringen i den angivne landestandard eller amerikansk engelsk som reserve. |
subtitle |
string | Underteksten på certificeringen i den angivne landestandard eller amerikansk engelsk som reserve. |
url |
string | En fuldt gyldig URL-adresse til certificeringen i Microsoft Learn i den ønskede landestandard. |
icon_url |
string | En fuldt kvalificeret URL-adresse til et billede i formatet 100x100 SVG, der repræsenterer certificeringen. |
type |
string | Posttypen. Værdien vil altid være 'cert'. |
certification_type |
string | Certificeringstypen. De mulige værdier er 'fundamentals', 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
exams |
matrix af strenge | En liste over de tilknyttede eksamener, der kræves til denne certificering. Der kan refereres til oplysninger om enhederne i certificeringsposterne. |
levels |
matrix af strenge | En liste over de niveauer, der er knyttet til denne certificering, som angiver, hvor meget erfaring i rollen der er nødvendig for at forstå alle aspekter af denne certificering. Der kan refereres til oplysninger om enhederne i niveauposterne. |
roles |
matrix af strenge | En liste over de relevante jobroller for denne certificering. Der kan refereres til oplysninger om rollerne i rolleposterne. |
study_guide |
matrix af objekter | En liste over det tilknyttede indhold, der skal undersøges for denne certificering. Der kan refereres til oplysninger om objekterne i deres tilknyttede poster. |
Bemærk
Certificeringer, der kræver mere end én eksamen, vil være til stede i denne certificeringspost, der refererer til eksamensmatrixen.
Eksamensposter
Alle eksamensposter har 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"
}
]
}
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
uid |
string | Et entydigt id for dette modul - denne værdi vil være unik på tværs af hele MS Learn. |
title |
string | Titlen på eksamenen i den angivne landestandard eller amerikansk engelsk som reserve. |
subtitle |
string | Underteksten til eksamenen i den anmodede landestandard, eller amerikansk engelsk som reserve. |
display_name |
string | Det viste navn til eksamenen i den anmodede landestandard, eller amerikansk engelsk som reserve. |
url |
string | En fuldt kvalificeret URL-adresse til eksamenen i Microsoft Learn i den anmodede landestandard. |
icon_url |
string | En fuldt kvalificeret URL-adresse til et billede i formatet 100x100 SVG, der repræsenterer eksamenen. |
pdf_download_url |
string | En fuldt kvalificeret URL-adresse til PDF-filen, der beskriver de færdigheder, der måles af denne eksamen. |
practice_test_url |
string | En fuldt kvalificeret URL-adresse til en øvelsestest, der er knyttet til eksamen. |
practice_assessment_url |
string | En fuldt kvalificeret URL-adresse til en gratis praksisvurdering, der er knyttet til eksamen. |
locales |
matrix af strenge | En liste over sprog, som denne eksamen tilbydes i. |
type |
string | Posttypen. Værdien vil altid være 'eksamen'. |
courses |
matrix af strenge | En liste over de tilknyttede kursus-UID'er. Der kan refereres til oplysninger om kurserne i kursusposterne. |
levels |
matrix af strenge | En liste over de niveauer, der er knyttet til denne eksamen, som angiver, hvor meget erfaring i rollen der er nødvendig for at forstå alle aspekter af denne eksamen. Der kan refereres til oplysninger om enhederne i niveauposterne. |
roles |
matrix af strenge | En liste over de relevante jobroller for denne eksamen. Der kan refereres til oplysninger om rollerne i rolleposterne. |
products |
matrix af strenge | En liste over relevante produkter, som er omfattet af denne eksamen. Der kan refereres til oplysninger om produkterne i produktposterne. |
providers |
matrix af objekter | En liste over udbydere til denne eksamen. Typen beskriver, hvilken udbyder og en fuldt kvalificeret URL-adresse med et link til at planlægge en eksamen med udbyderen. |
study_guide |
matrix af objekter | En liste over det tilknyttede indhold, der skal undersøges til denne eksamen. Der kan refereres til oplysninger om objekterne i deres tilknyttede poster. |
Instruktørledede kursusposter
Alle kursusposter har 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"
}
]
},
Feltoplysninger
| Felt | Type | Beskrivelse |
|---|---|---|
uid |
string | Et unikt id for dette instruktørledede kursus – denne værdi vil være unik på tværs af hele MS Learn. |
course_number |
string | Den instruktørledede kursusnummeridentifikator. |
title |
string | Titlen på det instruktørledede kursus i den angivne landestandard eller amerikansk engelsk som reserve. |
summary |
string | En streng, der indeholder en kort beskrivelse af læringsforløbet. Værdien angives som en HTML-afsnitskode, hvor den indre tekst er resuméet. |
duration_in_hours |
integer | Den gennemsnitlige tid, dette instruktørledede kursus tager at fuldføre i timer. |
url |
string | En fuldt gyldig URL-adresse til den instruktørledede kursusside i Microsoft Learn i den ønskede landestandard. |
icon_url |
string | En fuldt kvalificeret URL-adresse til et 100x100 SVG-billede, der repræsenterer den instruktørledede kursuspræstation. |
locales |
matrix af strenge | En liste over sprog, som dette instruktørledede kursus tilbydes officielt i. Andre sprog kan understøttes af læringspartnere. |
type |
string | Posttypen. Værdien vil altid være 'kursus' for instruktørledede kurser. |
certification |
string | Certificering knyttet til det instruktørledede kursus. |
exam |
string | Eksamen tilknyttet det instruktørledede kursus. |
levels |
matrix af strenge | En liste over de niveauer, der er knyttet til dette instruktørledede kursus, som angiver, hvor meget erfaring i rollen der er nødvendig for at forstå alle aspekter af dette kursus. Der kan refereres til oplysninger om enhederne i niveauposterne. |
study_guide |
matrix af objekter | En fuldt kvalificeret URL-adresse til PDF-filen, der beskriver de færdigheder, der måles af denne certificering. |
Poster for niveau, produkt, rolle og emne
Samlingerne levels, products, roles og subjects indeholder brugervenlige navne på de værdier, der anvendes i dataene i moduler og læringsforløb. 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 svarer til værdierne for niveauer, produkter, roller og emner, der er inkluderet i de andre katalogposter. Den tilknyttede name indeholder et korrekt engelsk navn på posten. children-matrixet er valgfrit og muliggør hierarki for værdier, der har underordnede relationer, f.eks. produkter.
Her er f.eks. et sæt 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 eksempel på et sæt produkter, hvor underordnede elementer er inkluderet for at give en mere specifik 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
Der er mange måder at kalde på Learn Catalog-API'en, men kodeeksemplerne nedenfor er eksempler på, hvordan det kan bruges.
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 hjælp af cURL-udvidelse
<?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 vha. bibliotek med 'anmodninger'
#!/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)
Næste trin
Gennemse ressourcerne nedenfor for at hjælpe dig på din udviklingsrejse: