Dela via


Referensdokumentation för Microsoft Learn Catalog API-utvecklare

Den här artikeln innehåller information för utvecklare och begäranden som implementerar Microsoft Learn Catalog-API:et. Vi rekommenderar också att du kollar in metodtips för Learn Catalog API, viktig information och artiklar med vanliga frågor för att stödja din utvecklingsresa.

API-slutpunkt

Katalog-API:et för Microsoft Learn är ett REST-baserat webb-API som returnerar ett JSON-kodat svar. Om du vill begära hela katalogen så skicka en GET-begäran till:

https://learn.microsoft.com/api/catalog/

Kommentar

Slutpunkten ovan är den aktuella slutpunkten. Om du använder en annan, äldre slutpunkt, så fungerar den gamla slutpunkten fortfarande som förväntat, men fördelarna med att växla till den nya slutpunkten är att den ger dig förbättrade funktioner, exempelvis ytterligare frågeparametrar.

Frågeparametrar

Följande frågeparametrar är de frågeparametrar som begäran kan innehålla. Allt är valfritt. Du måste URL-koda frågeparameterns värden. Du kan använda slutpunkten med en, några, alla eller inga alls av dessa parametrar.

Viktigt!

Om du använder mer än en utvärderas frågan med operatorn AND.

Namn Värde Type Obligatoriskt Exempel
nationella inställningar En giltig språkkod från listan över språk som stöds. Metadata returneras på det begärda språket, om möjligt. Om den här parametern inte anges returneras svaret en-us. sträng Inga ?locale=en-us
type En kommaavgränsad lista med ett eller flera av de innehålls- eller taxonomiobjekt på den översta nivån som vi för närvarande tillhandahåller i det returnerade svaret. Värden som stöds är: modules, units, learningPaths, appliedSkills, certifications, mergedCertifications, exams, levelscourses, , roles, products, subjects. sträng Inga ?type=modules,learningPaths
uid En kommaavgränsad lista med ett eller flera giltiga unika innehålls-ID:n (UID) från de tillgängliga innehållstyperna. Obs: UID:n är skiftlägeskänsliga. sträng Inga ?uid=learn.azure.intro-to-azure-fundamentals
last_modified En operator och datetime som ska filtreras efter det senast ändrade datumet för objekt. Operatorn innehåller lt (mindre än), lte (mindre än eller lika med), eq (lika med), gt (större än), gte (större än eller lika med). När du använder den här parametern får operatorn standardvärdet gte inget annat anges. sträng Inga ?last_modified=gte 2022-01-01
popularitet En operator och ett värde som ska filtreras efter popularitetsvärdet för objekt (i ett intervall på 0–1). Operatorn innehåller lt (mindre än), lte (mindre än eller lika med), eq (lika med), gt (större än), gte (större än eller lika med). När du använder den här parametern får operatorn standardvärdet gte inget annat anges. sträng Inga ?popularity=gte 0.5
nivå En kommaavgränsad lista med en eller flera av de nivåer som vi för närvarande har tillgängliga (en fullständig lista finns i objektet nivåer i API-svaret). sträng Inga ?level=beginner
roll En kommaavgränsad lista med en eller flera av de roller som vi för närvarande har tillgängliga (en fullständig lista finns i objektet roller i API-svaret). sträng Inga ?role=developer
produkt En kommaavgränsad lista med en eller flera av de roller som vi för närvarande har tillgängliga (en fullständig lista finns i objektet produkter i API-svaret). API:et stöder inte produkthierarki, så lägg till varje produkt i listan som du vill inkludera i din fråga. sträng Inga ?product=azure
certifikatmottagare En kommaavgränsad lista med en eller flera av de roller som vi för närvarande har tillgängliga (en fullständig lista finns i objektet ämnen i API-svaret). API:et stöder inte ämneshierarki, så lägg till varje ämne i listan som du vill ta med i frågan. sträng Inga ?subject=cloud-computing

Exempelfrågor

Frågorna nedan är exempel som hjälper dig att få en uppfattning om vad du kan begära och hur du kan skapa en begäran.

Description Söka i data
Alla objekt i Learn Catalog-API:et https://learn.microsoft.com/api/catalog/
Alla spanska moduler https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules
Alla moduler med en popularitetspoäng på 0,9 eller högre https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9
Alla säkerhetsutbildnings- och certifieringsobjekt för nybörjare https://learn.microsoft.com/api/catalog/?level=beginner&subject=security
Alla avancerade tillgänglighetsmoduler med en popularitetspoäng på mer än 0,5 och som uppdaterats under den senaste månaden https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01

API-svar

Tjänsten kan returnera följande HTTP-statuskoder.

Statuskod Description
200 Lyckades. Själva svaret innehåller JSON-kodade data.
400 En av frågeparametrarna saknas eller är ogiltig.
404 Det gick inte att hitta URL:en på servern.
500 Oväntat serverfel.
503 Tjänsten är inte tillgänglig för tillfället.

Ett lyckat svar innehåller information om alla moduler och utbildningsvägar, som du ser nedan.

Själva svaret

En lyckad svarstext kodas i JSON och har 12 avsnitt:

{
    "modules": [ ... ],
    "units": [...],
    "learningPaths": [ ... ],
    "appliedSkills": [ ... ],
    "mergedCertifications": [ ... ],
    "certifications": [ ... ],
    "exams": [ ... ],
    "courses": [ ... ],
    "levels": [ ... ],
    "products": [ ... ],
    "roles": [ ... ],
    "subjects": [...],
}

Varje matris har ett eller flera JSON-kodade objekt som innehåller data som är specifika för just det avsnittet i svaret.

  1. modules: är en matris med publicerade moduler.
  2. units: är en matris med publicerade enheter.
  3. learningPaths: är en matris med publicerade utbildningsvägar.
  4. appliedSkills: är en matris med publicerade tillämpade kunskaper.
  5. mergedCertifications: är en matris med publicerade certifieringar som sammanfogats med tentor.
  6. certifications: är en matris med publicerade certifieringar.
  7. exams: är en matris med publicerade prov.
  8. courses: är en matris med publicerade lärarledda kurser.
  9. levels: är en matris med möjliga målgruppsnivåer.
  10. products: är en matris med möjliga produkter och tjänster som ingår i katalogen.
  11. roles: är en matris med möjliga jobbroller.
  12. subjects: är en matris med möjliga ämnestaggar.

Poster för moduler

Poster för moduler

Varje modul har följande format:

{
    "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
}

Fältinformation

Fält Type Description
summary sträng En sträng med en kort beskrivning av modulen. Värdet uttrycks som en HTML-tagg för stycke, där den omslutna texten är sammanfattningen.
levels strängmatris En lista med de nivåer som är associerade med den här modulen, vilket indikerar hur stor erfarenhet av rollen som krävs för att förstå den här modulens alla aspekter. Information om enheterna hittar du i nivåposterna.
roles strängmatris En lista med de jobbroller som modulen är relevant för.
products strängmatris En lista över relevanta produkter som modulen täcker. Information om produkterna hittar du i produktposterna.
subjects strängmatris En lista över relevanta ämnen som utbildningsvägen täcker in.
uid sträng En unik identifierare för modulen – det här värdet är unikt för hela MS Learn.
type sträng Typen av post. Värdet är alltid ”module”.
title sträng Namnet på modulen på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
duration_in_minutes integer Genomsnittlig tid i minuter som det tar att genomföra modulen.
rating objekt Innehåller både count, som är antalet personer som har betygsatt modulen, och average, ett aggregat av betygen, som blir 1–5
popularity dubbel Ett normaliserat värde från 0–1 indikerar modulens popularitet
icon_url sträng En fullständigt kvalificerad URL till en SVG-bild på 100 x 100 som representerar modulens prestationsbild med en transparent bakgrund.
social_image_url sträng En fullständigt kvalificerad URL till en PNG-bild som representerar modulprestationsbilden med en rektangulär ogenomskinlig bakgrund som passar för sociala medier eller paneler. Om den inte är tillgänglig för den här modulen returneras inte den här egenskapen i svaret.
locale sträng Språket som dessa JSON-data skrivits på. Det här värdet är det begärda språket om det är tillgängligt. Om inte, används ”en-US”.
last_modified datum Datumet för de senaste större ändringarna av modulen.
url sträng En fullständigt kvalificerad URL till Learn-modulen på det begärda språket.
firstUnitUrl sträng En fullständigt kvalificerad URL till den första enheten i Learn-modulen på det begärda språket.
units strängmatris En lista med de associerade enhets-UID:erna. Information om enheterna hittar du i enhetsposterna.
number_of_children integer Antalet sidor (enheter) som modulen innehåller.

Enhetsposter

Varje enhetspost har följande format:

{
    "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"
},

Kommentar

Enhetsposten har inte den associerade URL:en eftersom enheter inte skrivs som fristående innehåll. De är avsedda att tas i en viss ordning för modulen. Det är av det här skälet vi inkluderar länken till modulinformationssidan och den första enheten i modulposten, så att användarna kan börja där och fortsätta genom innehållet. Enhetsposterna kan dock användas för att få information om de enheter som ska visas i LMSes och annat.

Fältinformation

Fält Type Description
uid sträng En unik identifierare för modulen – det här värdet är unikt för hela MS Learn.
type sträng Typen av post. Värdet är alltid ”enhet”.
title sträng Namnet på enheten på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
duration_in_minutes Enhetens varaktighet. Om du lägger till alla duration_in_minutes för de enheter som är associerade med respektive modul får du den totala modultiden.
locale sträng Språket som dessa JSON-data skrivits på. Det här värdet är det begärda språket om det är tillgängligt. Om inte, används ”en-US”.
last_modified datum Datumet för de senaste större ändringarna av modulen.

Poster för utbildningsvägar

Varje utbildningsvägspost har följande format:

{
    "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
}

Fältinformation

Fält Type Description
summary sträng En sträng med en kort beskrivning av utbildningsvägen. Värdet uttrycks som en HTML-tagg för stycke, där den omslutna texten är sammanfattningen.
levels strängmatris En lista med de nivåer som är associerade med den här utbildningsvägen, vilket indikerar hur stor erfarenhet av rollen som krävs för att förstå den här utbildningsvägens alla aspekter. Information om enheterna hittar du i nivåposterna.
roles strängmatris En lista med relevanta jobbroller för utbildningsvägen.
products strängmatris En lista över relevanta produkter som utbildningsvägen täcker. Information om produkterna hittar du i produktposterna.
subjects strängmatris En lista över relevanta ämnen som utbildningsvägen täcker in.
uid sträng En unik identifierare för utbildningsvägen – det här värdet är unikt för hela MS Learn.
type sträng Typen av post. Värdet är alltid ”learningPath”.
title sträng Namnet på utbildningsvägen på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
duration_in_minutes integer Genomsnittlig tid i minuter som det tar att genomföra utbildningsvägen. Det här värdet är summan av data från alla moduler som ingår.
rating objekt Innehåller både count, som är antalet personer som har betygsatt utbildningsvägen, och average, en sammanvägning av betygen, vilket blir 1-5
popularity dubbel Ett normaliserat värde från 0–1 indikerar utbildningsvägens popularitet
icon_url sträng En fullständigt kvalificerad URL till en .SVG-bild med storleken 100 × 100 som representerar utbildningsvägen.
social_image_url sträng En fullständigt kvalificerad URL till en PNG-bild som representerar utbildningsvägsprestationsbilden med en rektangulär ogenomskinlig bakgrund som passar för sociala medier eller paneler. Om den inte är tillgänglig för den här modulen returneras inte den här egenskapen i svaret.
locale sträng Språket som dessa JSON-data skrivits på. Det här värdet är det begärda språket om det är tillgängligt. Om inte, används ”en-US”.
last_modified datum Senaste gången utbildningsvägen ändrades.
url sträng En fullständigt kvalificerad URL till utbildningsvägen i Microsoft Learn på det begärda språket.
firstModuleUrl sträng En fullständigt kvalificerad URL till utbildningsvägens första modul i Microsoft Learn på det begärda språket.
modules strängmatris En lista med associerade modul-UID:n. Information om modulerna hittar du i modulposterna.
number_of_children integer Antalet moduler som ingår i utbildningsvägen.

Applied Skills-poster

Varje applied skills-post har följande formulär:

{
    "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"
}

Fältinformation

Fält Type Description
uid sträng En unik identifierare för den här tillämpade färdigheten – det här värdet kommer att vara unikt för hela MS Learn.
locale sträng Språket som dessa JSON-data skrivits på. Det här värdet är det begärda språket om det är tillgängligt. Om inte, används ”en-US”.
title sträng Rubriken för tillämpad färdighet på det begärda nationella språket, eller amerikansk engelska som reserv.
summary sträng Sammanfattningen av tillämpad färdighet på det begärda nationella språket eller amerikansk engelska som reserv.
url sträng En fullständigt kvalificerad URL till den tillämpade färdigheten i Microsoft Learn på det begärda språket.
icon_url sträng En fullständigt kvalificerad URL till en 100x100 SVG-avbildning som representerar den tillämpade färdigheten (när den är tillgänglig, annars inte inkluderad).
levels strängmatris En lista över de nivåer som är associerade med den här tillämpade färdigheten.
roles strängmatris En lista över relevanta jobbroller för den här tillämpade färdigheten. Information om rollerna hittar du i rollposterna.
subjects strängmatris En lista över relevanta ämnen som omfattas av tillämpad kompetens.
study_guide en matris med objekt En lista över det associerade innehåll som ska studeras för den här tillämpade färdigheten. Information om objekten hittar du i deras associerade poster.
last_modified datum Senaste gången den tillämpade färdigheten ändrades.

Sammanfogade certifieringsposter

Varje sammanslagen certifieringspost har följande formulär:

{
    "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": []
}

Fältinformation

Fält Type Description
uid sträng En unik identifierare för certifieringen – det här värdet är unikt för hela MS Learn.
title sträng Namnet på certifieringen på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
summary sträng Sammanfattningen för certifieringen på det begärda nationella språket eller amerikansk engelska som reserv.
url sträng En fullständigt kvalificerad URL till certifieringen i Microsoft Learn på det begärda språket.
icon_url sträng En fullständigt kvalificerad URL till en .SVG-bild med storleken 100 × 100 som representerar certifieringen.
last_modified datum Senast den här certifieringen ändrades.
type sträng Typen av post. Värdet är alltid ”cert”.
certification_type sträng Typ av certifiering. Möjliga värden är "fundamentals", "mce", "mcsa", "mcsd", "mcse", "mos", "mta", "role-based", "specialty".
products strängmatris En lista över relevanta produkter som certifieringen omfattar. Information om produkterna hittar du i produktposterna.
levels strängmatris En lista med de nivåer som är associerade med den här certifieringen, vilket indikerar hur stor erfarenhet av rollen som krävs för att förstå alla aspekter av proverna för den här certifieringen. Information om enheterna hittar du i nivåposterna.
roles strängmatris En lista med relevanta jobbroller för certifieringen. Information om rollerna hittar du i rollposterna.
subjects strängmatris En lista över relevanta ämnen som certifieringen omfattar.
renewal_frequency_in_days integer Antalet dagar innan certifieringen upphör att gälla och måste förnyas. Om värdet är 0 upphör certifieringen inte att gälla.
prerequisites strängmatris En lista över rekommenderade förutsättningar för att få den här certifieringen. Information om certifieringarna kan refereras till i certifieringsposterna.
skills strängmatris En lista över de färdigheter som mäts på det prov som krävs för den här certifieringen.
recommendation_list strängmatris En lista över rekommenderade frågor som rör den här certifieringen.
study_guide en matris med objekt En lista med det associerade innehåll som ska studeras för den här certifieringen. Information om objekten hittar du i deras associerade poster.
exam_duration_in_minutes integer Antalet minuter som tilldelats för att slutföra provet.
locales strängmatris En lista över de språk som certifieringen erbjuds i.
providers en matris med objekt En lista över leverantörer för den här certifieringen. Typen beskriver leverantören och en fullständigt kvalificerad URL med en länk för att schemalägga ett prov med leverantören tillhandahålls.
career_paths en matris med objekt En lista över karriärvägar för den här certifieringen.

Kommentar

Certifieringar som bara kräver ett prov returneras som en del av den här egenskapen mergedCertifications.

Certifieringsposter

Varje certifieringspost har följande format:

{
    "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"
        }
    ]
}

Fältinformation

Fält Type Description
uid sträng En unik identifierare för certifieringen – det här värdet är unikt för hela MS Learn.
title sträng Namnet på certifieringen på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
subtitle sträng Certifieringens undertext på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
url sträng En fullständigt kvalificerad URL till certifieringen i Microsoft Learn på det begärda språket.
icon_url sträng En fullständigt kvalificerad URL till en .SVG-bild med storleken 100 × 100 som representerar certifieringen.
type sträng Typen av post. Värdet är alltid ”cert”.
certification_type sträng Typ av certifiering. Möjliga värden är "fundamentals", "mce", "mcsa", "mcsd", "mcse", "mos", "mta", "role-based", "specialty".
exams strängmatris En lista med de associerade prov som krävs för den här certifieringen. Information om enheterna hittar du i certifieringsposterna.
levels strängmatris En lista med de nivåer som är associerade med den här certifieringen, vilket indikerar hur stor erfarenhet av rollen som krävs för att förstå alla aspekter av proverna för den här certifieringen. Information om enheterna hittar du i nivåposterna.
roles strängmatris En lista med relevanta jobbroller för certifieringen. Information om rollerna hittar du i rollposterna.
study_guide en matris med objekt En lista med det associerade innehåll som ska studeras för den här certifieringen. Information om objekten hittar du i deras associerade poster.

Kommentar

Certifieringar som kräver mer än ett prov kommer att finnas i den här certifieringsposten som refererar till testmatrisen.

Provposter

Varje provpost har följande format:

{
    "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&amp;utm_medium=certpage&amp;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"
        }
    ]
}

Fältinformation

Fält Type Description
uid sträng En unik identifierare för provet – det här värdet är unikt för hela MS Learn.
title sträng Namnet på provet på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
subtitle sträng Provets undertext på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
display_name sträng Provets visningsnamn på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
url sträng En fullständigt kvalificerad URL till provet i Microsoft Learn på det begärda språket.
icon_url sträng En fullständigt kvalificerad URL till en .SVG-bild med storleken 100 × 100 som representerar provet.
pdf_download_url sträng En fullständigt kvalificerad URL till PDF-filen som beskriver de färdigheter som mäts i det här provet.
practice_test_url sträng En fullständigt kvalificerad URL till ett övningstest som är associerat med provet.
practice_assessment_url sträng En fullständigt kvalificerad URL till en kostnadsfri utvärdering som är associerad med provet.
locales strängmatris En lista med de språk som provet erbjuds i.
type sträng Typen av post. Värdet är alltid ”prov”.
courses strängmatris En lista med associerade kurs-UID:n. Information om kurserna hittar du i kursposterna.
levels strängmatris En lista med de nivåer som är associerade med det här provet, vilket indikerar hur stor erfarenhet av rollen som krävs för att förstå det här provets alla aspekter. Information om enheterna hittar du i nivåposterna.
roles strängmatris En lista med relevanta jobbroller för det här provet. Information om rollerna hittar du i rollposterna.
products strängmatris En lista över relevanta produkter som provet täcker. Information om produkterna hittar du i produktposterna.
providers en matris med objekt En lista med leverantörer för det här provet. Typen beskriver leverantören och en fullständigt kvalificerad URL med en länk för att schemalägga ett prov med leverantören tillhandahålls.
study_guide en matris med objekt En lista med det associerade innehåll som ska studeras för det här provet. Information om objekten hittar du i deras associerade poster.

Lärarledda kursposter

Varje kurspost har följande format:

{
    "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"
        }
    ]
},

Fältinformation

Fält Type Description
uid sträng En unik identifierare för den här lärarledda kursen – det här värdet är unikt för hela MS Learn.
course_number sträng Nummeridentifierare för lärarledd kurs.
title sträng Namnet på den lärarledda kursen på det begärda språket, eller på engelska om det begärda språket inte är tillgängligt.
summary sträng En sträng som tillhandahåller en kort beskrivning av den lärarledda kursen. Värdet uttrycks som en HTML-tagg för stycke, där den omslutna texten är sammanfattningen.
duration_in_hours integer Den genomsnittliga tid i timmar som den här lärarledda kursen tar att slutföra.
url sträng En fullständigt kvalificerad URL till sidan med information om den lärarledda kursen i Microsoft Learn på det begärda språket.
icon_url sträng En fullständigt kvalificerad URL till en SVG-bild på 100 x 100 som representerar den lärarledda kursprestationen.
locales strängmatris En lista med de språk i vilka denna instruktörsledda kurs officiellt tillhandahålls. Andra språk kan stödjas av utbildningspartner.
type sträng Typen av post. Värdet är alltid "kurs" för lärarledda kurser.
certification sträng Certifiering som är associerad med den lärarledda kursen.
exam sträng Prov som är associerat med den lärarledda kursen.
levels strängmatris En lista med de nivåer som är associerade med den här lärarledda kursen, vilket indikerar hur stor erfarenhet av rollen som krävs för att förstå den här lärarledda kursens alla aspekter. Information om enheterna hittar du i nivåposterna.
study_guide en matris med objekt En fullständigt kvalificerad URL till PDF-filen som beskriver de färdigheter som mäts i den här certifieringen.

Nivå-, produkt-, roll- och ämnesposter

Samlingarna levels, products, roles och subjects tillhandahåller egna namn för värdena som används i data för moduler och utbildningsvägar. Alla fyra samlingarna har samma form:

{
    "id": "unique-id",
    "name": "name-of-item",
    "children": [
        { "id": "unique-id", "name": "name-of-item" },
        { "id": "unique-id", "name": "name-of-item" },
           ...
    ]
}

id matchar värdena för de nivåer, produkter, roller och ämnen som ingår i de andra katalogposterna. Tillhörande name innehåller ett namn på engelska för posten. children-matrisen är valfri och kan användas för hierarkier när värden har underordnade relationer, till exempel produkter.

Här är ett exempel på en uppsättning möjliga roller:

{
    ...
    "roles": [
        {
            "id": "administrator",
            "name": "Administrator"
        },
        {
            "id": "ai-engineer",
            "name": "AI Engineer"
        },
        {
            "id": "business-analyst",
            "name": "Business Analyst"
        },
        {
            "id": "developer",
            "name": "Developer"
        },
        ...
    ]
}

Här är ett exempel på en uppsättning produkter, med underordnade objekt som definierar en mer 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"
        },
        ...
    ]
}

Kodexempel

Det finns många sätt att anropa Learn-katalog-API:et, men kodexemplen nedan är exempel på hur det kan göras.

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 med cURL-tillägget

<?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 med "requests"-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)

Nästa steg

Granska resurserna nedan för att hjälpa dig med din utvecklingsresa: