Referenčná dokumentácia pre vývojárov k API pre Microsoft Learn Catalog
Tento článok poskytuje informácie pre vývojárov a žiadateľov o implementáciu rozhrania API pre Microsoft Learn Catalog. Odporúčame vám tiež preštudovať si najvhodnejšie postupy rozhrania API pre Learn Catalog, poznámky k vydaniu a články s najčastejšími otázkami, ktoré podporia vašu cestu k vývoju.
Koncový bod rozhrania API
Rozhranie API pre Microsoft Learn Catalog je webovým rozhraním API založeným na architektúre REST, ktoré vracia odozvu kódovanú použitím JSON. Ak chcete požiadať o úplný katalóg, odošlite požiadavku GET na adresu:
https://learn.microsoft.com/api/catalog/
Poznámka
Koncový bod uvedený vyššie je aktuálny koncový bod. Ak používate iný, starší koncový bod, bude fungovať podľa očakávania aj po pridaní do systému, ale výhody prepnutia na nový koncový bod sú v tom, že vám poskytnú vylepšené funkcie, ako sú napríklad ďalšie parametre dotazu.
Parametre dotazu
Nižšie sú uvedené parametre dotazu, ktoré môže žiadosť obsahovať. Všetky sú voliteľné. Musíte URL adresu zakódovať pomocou hodnôt parametrov dotazu. Koncový bod môžete použiť so žiadnymi, jedným, niektorými alebo všetkými týmito parametrami.
Dôležité
Ak použijete viac ako jeden dotaz, vyhodnotí sa pomocou operátora AND.
| Meno | Hodnota | Zadať | Požaduje sa | Príklad |
|---|---|---|---|---|
| miestne | Jeden platný kód miestneho nastavenia zo zoznamu podporovaných miestnych nastavení. Vrátené metaúdaje budú mať požadovaný formát podľa miestnych nastavení. Ak tento parameter nebol zadaný, en-us vráti sa odpoveď. |
povrázok | No | ?locale=en-us |
| typ | Zoznam položiek oddelených čiarkou s jedným alebo viacerými objektmi najvyššej úrovne obsahu alebo taxonómií, ktoré momentálne poskytujeme v odpovedi na vrátenie. Podporované hodnoty sú: modules, , unitslearningPaths, appliedSkills, certifications, , mergedCertifications, exams, courses, levels, roles, products, subjects. |
povrázok | No | ?type=modules,learningPaths |
| Uid | Zoznam jedinečných ID (uid) obsahu oddelených čiarkou z dostupných typov obsahu. Poznámka: Pomocou identifikátorov sa rozlišujú veľké a malé písmená. | povrázok | No | ?uid=learn.azure.intro-to-azure-fundamentals |
| last_modified | Operátor a datetime na filtrovanie podľa dátumu poslednej úpravy objektov. Operátor zahŕňa lt (menšie ako), lte (menšie ako alebo rovná sa), eq (rovná sa), gt (väčšie ako), gte (väčšie ako alebo rovná sa). Keď použijete tento parameter, operátor bude predvolene nastavený na gte hodnotu , ak tento parameter nebol zadaný. |
povrázok | No | ?last_modified=gte 2022-01-01 |
| Popularity | Operátor a hodnotu, ktorá sa má filtrovať podľa hodnoty popularity (v rozsahu 0 – 1) objektov. Operátor zahŕňa lt (menšie ako), lte (menšie ako alebo rovná sa), eq (rovná sa), gt (väčšie ako), gte (väčšie ako alebo rovná sa). Keď použijete tento parameter, operátor bude predvolene nastavený na gte hodnotu , ak tento parameter nebol zadaný. |
povrázok | No | ?popularity=gte 0.5 |
| úroveň | Zoznam s hodnotami oddelenými čiarkou jednej alebo viacerých úrovní, ktoré máme v súčasnosti k dispozícii (úplný zoznam je v objekte úrovní odpovede rozhrania API). | povrázok | No | ?level=beginner |
| Úlohu | Zoznam s hodnotami oddelenými čiarkou jednej alebo viacerých rolí, ktoré máme v súčasnosti k dispozícii (úplný zoznam je v objekte roly v odpovedi rozhrania API). | povrázok | No | ?role=developer |
| Produkt | Zoznam s hodnotami oddelenými čiarkou jednej alebo viacerých rolí, ktoré máme v súčasnosti k dispozícii (úplný zoznam je v objekte rozhrania API pre produkty ). Rozhranie API nepodporuje hierarchiu produktov, takže pridajte každý produkt do zoznamu, ktorý chcete zahrnúť do dotazu. | povrázok | No | ?product=azure |
| Predmet | Zoznam rolí oddelených čiarkou jednej alebo viacerých rolí, ktoré máme aktuálne k dispozícii (úplný zoznam je v predmetoch objektu odpovede rozhrania API). Rozhranie API nepodporuje hierarchiu predmetu, preto pridajte každý predmet do zoznamu, ktorý chcete zahrnúť do dotazu. | povrázok | No | ?subject=cloud-computing |
Vzorové otázky
Dotazy uvedené nižšie sú ukážky, ktoré vám pomôžu získať predstavu o tom, čo môžete požiadať a ako vytvoriť žiadosť.
| Description | Query |
|---|---|
| Všetky položky v rozhraní API pre Learn Catalog | https://learn.microsoft.com/api/catalog/ |
| Všetky španielske moduly | https://learn.microsoft.com/api/catalog/?locale=es-es&type=modules |
| Všetky moduly so skóre popularity 0,9 alebo viac | https://learn.microsoft.com/api/catalog/?type=modules&popularity>0.9 |
| Všetky školenia o zabezpečení a objekty certifikácie pre začiatočníkov | https://learn.microsoft.com/api/catalog/?level=beginner&subject=security |
| Všetky pokročilé moduly na zjednodušenie ovládania s skóre popularity viac ako 0,5 a aktualizované za posledný mesiac | https://learn.microsoft.com/api/catalog/?level=advanced&subject=accessibility&popularity>0.5&last_modified=gte 2022-10-01 |
Odpoveď rozhrania API
Služba môže vrátiť nasledujúce kódy stavu protokolu HTTP.
| Kód stavu | Description |
|---|---|
| 200 | Úspešné. Telo odozvy obsahuje údaje kódované použitím JSON. |
| 400 | Jeden z parametrov dotazu chýba alebo je neplatný. |
| 404 | URL adresa sa nenašla na serveri. |
| 500 | Neočakávaná chyba servera. |
| 503 | Služba je dočasne nedostupná. |
Odpoveď na správne zadefinovaný dotaz bude obsahovať podrobnosti o všetkých moduloch a študijných programoch, ako je to znázornené nižšie.
Text odozvy
Text úspešnej odozvy bude kódovaný vo formáte JSON a bude mať 12 sekcií:
{
"modules": [ ... ],
"units": [...],
"learningPaths": [ ... ],
"appliedSkills": [ ... ],
"mergedCertifications": [ ... ],
"certifications": [ ... ],
"exams": [ ... ],
"courses": [ ... ],
"levels": [ ... ],
"products": [ ... ],
"roles": [ ... ],
"subjects": [...],
}
Každé pole obsahuje minimálne jeden objekt zakódovaný použitím JSON a obsahujúci údaje špecifické pre danú časť odpovede.
modules: je pole publikovaných modulov.units: je pole publikovaných jednotiek.learningPaths: je pole publikovaných študijných programov.appliedSkills: je pole publikovaných použitých zručností.mergedCertifications: je pole publikovaných certifikácií zlúčených so skúškami.certifications: je pole publikovaných certifikácií.exams: je pole publikovaných skúšok.courses: je pole publikovaných kurzov školení vedených inštruktorom.levels: je pole možných úrovní príjemcov.products: je pole možných produktov a služieb, ktoré sú zahrnuté v katalógu.roles: je pole možných úrovní úloh.subjects: je pole možných značiek predmetu.
Záznamy modulov
Záznamy modulov
Každý záznam modulu bude mať nasledujúci tvar:
{
"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
}
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
summary |
povrázok | Reťazec, ktorý obsahuje krátky popis modulu. Hodnota sa vyjadruje ako značka odseku HTML s vnútorným textom, ktorý je súhrnom. |
levels |
pole reťazcov | Zoznam úrovní súvisiacich s týmto modulom, ktoré označujú, koľko skúseností v danej úlohe je potrebné na pochopenie všetkých aspektov tohto modulu. Na podrobnosti o jednotkách možno odkazovať v záznamoch na úrovni. |
roles |
pole reťazcov | Zoznam povolaní, pre ktoré je tento modul relevantný. |
products |
pole reťazcov | Zoznam relevantných produktov, ku ktorým sa modul vzťahuje. Na podrobnosti o produktoch môžete odkazovať v záznamoch produktov. |
subjects |
pole reťazcov | Zoznam relevantných tém, ktoré študijný program zahŕňa. |
uid |
povrázok | Jedinečný identifikátor pre tento modul – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
type |
povrázok | Typ záznamu. Hodnotou bude vždy „modul“. |
title |
povrázok | Názov modulu v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
duration_in_minutes |
celé číslo | Priemerný čas splnenia tohto modulu v minútach. |
rating |
Objekt | Obsahuje ako , čo je počet ľudí, ktorí ohodnotili modul, ako averageaj countpoložku , čo je súhrn hodnotení, ktorý bude v hodnote 1 – 5. |
popularity |
Dvojlôžková | Normalizovaná hodnota v rozsahu 0 – 1 označujúca popularitu daného modulu. |
icon_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku veľkosti 100 x 100 SVG, ktorý predstavuje obrázok dosiahnutý modulu s priehľadným pozadím. |
social_image_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku vo formáte PNG, ktorý predstavuje obrázok úspechu modulu s obdĺžnikovým nepriehľadným pozadím vhodným pre prácu na sociálnych sieťach alebo dlaždiciach. Ak nie je k dispozícii pre tento modul, táto vlastnosť nebude vrátená v odpovedi. |
locale |
povrázok | Jazyk, v ktorom sú tieto údaje JSON napísané. Táto hodnota bude požadovaným miestnym jazykom, ak je dostupný, alebo v prípade jeho nedostupnosti to bude en-us. |
last_modified |
dátum | Čas poslednej hlavnej revízie tohto modulu. |
url |
povrázok | Plne kvalifikovaná URL adresa modulu Learn v požadovanom miestnom jazyku. |
firstUnitUrl |
povrázok | Plne kvalifikovaná URL adresa prvej lekcie modulu Learn v požadovanom miestnom jazyku. |
units |
pole reťazcov | Zoznam priradených identifikátorov U ID jednotiek. Na podrobnosti o jednotkách možno odkazovať v záznamoch jednotiek. |
number_of_children |
celé číslo | Počet strán (jednotiek), ktoré tento modul obsahuje. |
Záznamy jednotiek
Každý záznam lekcie bude mať nasledujúci tvar:
{
"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"
},
Poznámka
Záznam zariadenia nemá priradenú URL adresu, pretože jednotky nie sú napísané ako samostatný obsah. Sú určené na vykonanie v konkrétnom poradí pre modul. Z tohto dôvodu zahrnieme prepojenie na stránku s podrobnosťami modulu a prvú lekciu v zázname modulu, aby tam používatelia mohli začať a pokračovať obsahom. Záznamy jednotky je však možné použiť na získanie podrobností o jednotkách, ktoré sa majú zobraziť v systéme LMSes alebo iných prostrediach.
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
uid |
povrázok | Jedinečný identifikátor pre tento modul – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
type |
povrázok | Typ záznamu. Hodnotou bude vždy "jednotka". |
title |
povrázok | Názov lekcie v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
duration_in_minutes |
Trvanie lekcie. Ak pridáte všetky duration_in_minutes jednotiek priradených k jednotlivým modulom, získate celkový čas modulu. | |
locale |
povrázok | Jazyk, v ktorom sú tieto údaje JSON napísané. Táto hodnota bude požadovaným miestnym jazykom, ak je dostupný, alebo v prípade jeho nedostupnosti to bude en-us. |
last_modified |
dátum | Čas poslednej hlavnej revízie tohto modulu. |
Záznamy študijného programu
Každý záznam študijného programu bude mať nasledujúci formát:
{
"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
}
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
summary |
povrázok | Reťazec, ktorý obsahuje krátky popis študijného programu. Hodnota sa vyjadruje ako značka odseku HTML s vnútorným textom, ktorý je súhrnom. |
levels |
pole reťazcov | Zoznam úrovní spojených s týmto študijným programom, ktoré označujú, koľko skúseností v danej role je potrebné na pochopenie všetkých aspektov tohto študijného programu. Na podrobnosti o jednotkách možno odkazovať v záznamoch na úrovni. |
roles |
pole reťazcov | Zoznam relevantných rolí úloh pre tento študijný program. |
products |
pole reťazcov | Zoznam relevantných produktov, ku ktorým sa študijný program vzťahuje. Na podrobnosti o produktoch môžete odkazovať v záznamoch produktov. |
subjects |
pole reťazcov | Zoznam relevantných tém, ktoré študijný program zahŕňa. |
uid |
povrázok | Jedinečný identifikátor pre tento študijný program – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
type |
povrázok | Typ záznamu. Hodnotou bude vždy „learningPath“. |
title |
povrázok | Názov študijného programu v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
duration_in_minutes |
celé číslo | Priemerný čas splnenia tohto študijného programu v minútach. Táto hodnota je súčtom údajov zo všetkých zahrnutých modulov. |
rating |
Objekt | Obsahuje položku , čo je počet ľudí, ktorí ohodnotili študijný program, ako averageaj countpoložku , čo je súhrn hodnotení, ktorý bude v pomere 1 – 5. |
popularity |
Dvojlôžková | Normalizovaná hodnota v rozsahu 0 – 1 označujúca popularitu daného študijného programu. |
icon_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku svg veľkosti 100 x 100, ktorý predstavuje študijný program. |
social_image_url |
povrázok | Plne kvalifikovaná URL adresa na obrázok vo formáte PNG, ktorý predstavuje obrázok úspechu študijného programu s obdĺžnikovým nepriehľadným pozadím, vhodný pre prácu na sociálnych sieťach alebo dlaždiciach. Ak nie je k dispozícii pre tento modul, táto vlastnosť nebude vrátená v odpovedi. |
locale |
povrázok | Jazyk, v ktorom sú tieto údaje JSON napísané. Táto hodnota bude požadovaným miestnym jazykom, ak je dostupný, alebo v prípade jeho nedostupnosti to bude en-us. |
last_modified |
dátum | Čas poslednej zmeny tohto študijného programu. |
url |
povrázok | Úplná URL adresa študijného programu v službe Microsoft Learn v požadovanom miestnom jazyku. |
firstModuleUrl |
povrázok | Úplná URL adresa prvého modulu študijného programu v službe Microsoft Learn v požadovanom miestnom jazyku. |
modules |
pole reťazcov | Zoznam priradených identifikátorov U ID modulov. Na podrobnosti o moduloch môžete odkazovať v záznamoch modulov. |
number_of_children |
celé číslo | Počet modulov, ktoré študijný program obsahuje |
Záznamy použitých zručností
Každý záznam Applied Skills (Použité zručnosti) bude mať nasledujúci formát:
{
"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"
}
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
uid |
povrázok | Jedinečný identifikátor pre túto použitú odbornosť – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
locale |
povrázok | Jazyk, v ktorom sú tieto údaje JSON napísané. Táto hodnota bude požadovaným miestnym jazykom, ak je dostupný, alebo v prípade jeho nedostupnosti to bude en-us. |
title |
povrázok | Názov pre applied skill v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
summary |
povrázok | Súhrn použitých zručností v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
url |
povrázok | Plne kvalifikovaná URL adresa applied skill v službe Microsoft Learn v požadovanom miestnom jazyku. |
icon_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku svg veľkosti 100 x 100, ktorý predstavuje použité zručnosti (ak sú k dispozícii, inak nie sú zahrnuté). |
levels |
pole reťazcov | Zoznam úrovní priradených k tejto používanej zručnosti. |
roles |
pole reťazcov | Zoznam relevantných rolí úloh pre túto používanú odbornosť. Na podrobnosti o rolách môžete odkazovať v záznamoch rolí. |
subjects |
pole reťazcov | Zoznam relevantných tém, ktoré táto používaná zručnosť zahŕňa. |
study_guide |
pole objektov | Zoznam súvisiaceho obsahu, ktorý sa má študovať pre túto funkciu Applied Skill. Na podrobnosti o objektoch je možné odkazovať v priradených záznamoch. |
last_modified |
dátum | Čas poslednej zmeny tejto používanej zručnosti. |
Zlúčené záznamy o certifikácii
Každý zlúčený certifikačný záznam bude mať nasledujúci tvar:
{
"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": []
}
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
uid |
povrázok | Jedinečný identifikátor pre túto certifikáciu – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
title |
povrázok | Názov certifikácie v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
summary |
povrázok | Súhrn pre certifikáciu v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
url |
povrázok | Plne kvalifikovaná URL adresa certifikácie v službe Microsoft Learn v požadovanom miestnom jazyku. |
icon_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku svg veľkosti 100 x 100, ktorý predstavuje certifikáciu. |
last_modified |
dátum | Kedy bola táto certifikácia naposledy zmenená. |
type |
povrázok | Typ záznamu. Hodnotou bude vždy "cert". |
certification_type |
povrázok | Typ certifikácie. Možné hodnoty sú "fundamentals", 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
products |
pole reťazcov | Zoznam relevantných produktov, na ktoré sa vzťahuje táto certifikácia. Na podrobnosti o produktoch môžete odkazovať v záznamoch produktov. |
levels |
pole reťazcov | Zoznam úrovní priradených k tejto certifikácii, ktoré označujú, koľko skúseností v danej role je potrebné na pochopenie všetkých aspektov skúšok tejto certifikácie. Na podrobnosti o jednotkách možno odkazovať v záznamoch na úrovni. |
roles |
pole reťazcov | Zoznam relevantných rolí úloh pre túto certifikáciu. Na podrobnosti o rolách môžete odkazovať v záznamoch rolí. |
subjects |
pole reťazcov | Zoznam relevantných subjektov, na ktoré sa vzťahuje táto certifikácia. |
renewal_frequency_in_days |
celé číslo | Počet dní pred uplynutím platnosti tejto certifikácie a je potrebné ho obnoviť. Ak je hodnota 0, certifikácia neuplynie. |
prerequisites |
pole reťazcov | Zoznam odporúčaných predpokladov na získanie tejto certifikácie. Na podrobnosti o certifikáciách môžete odkazovať v záznamoch certifikácie. |
skills |
pole reťazcov | Zoznam zručností meraných na skúške potrebnej pre túto certifikáciu. |
recommendation_list |
pole reťazcov | Zoznam odporúčaných prvkov súvisiacich s touto certifikáciou. |
study_guide |
pole objektov | Zoznam priradeného obsahu na štúdium pre túto certifikáciu. Na podrobnosti o objektoch je možné odkazovať v priradených záznamoch. |
exam_duration_in_minutes |
celé číslo | Počet minút pridelených na dokončenie skúšky. |
locales |
pole reťazcov | Zoznam jazykov, v prípade ktoré je táto certifikácia k dispozícii. |
providers |
pole objektov | Zoznam poskytovateľov pre túto certifikáciu. Typ popisuje poskytovateľa a úplnú URL adresu s prepojením na naplánovanie skúšky u poskytovateľa. |
career_paths |
pole objektov | Zoznam kariérnych ciest pre túto certifikáciu. |
Poznámka
Certifikácie, ktoré vyžadujú iba jednu skúšku, sa vrátia ako súčasť tejto vlastnosti zlúčeného certifikátu.
Záznamy certifikácie
Každý záznam certifikácie bude mať nasledujúci tvar:
{
"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"
}
]
}
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
uid |
povrázok | Jedinečný identifikátor pre túto certifikáciu – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
title |
povrázok | Názov certifikácie v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
subtitle |
povrázok | Podnadpis certifikácie v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
url |
povrázok | Plne kvalifikovaná URL adresa certifikácie v službe Microsoft Learn v požadovanom miestnom jazyku. |
icon_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku svg veľkosti 100 x 100, ktorý predstavuje certifikáciu. |
type |
povrázok | Typ záznamu. Hodnotou bude vždy "cert". |
certification_type |
povrázok | Typ certifikácie. Možné hodnoty sú "fundamentals", 'mce', 'mcsa', 'mcsd', 'mcse', 'mos', 'mta', 'role-based', 'specialty'. |
exams |
pole reťazcov | Zoznam priradených skúšok požadovaných pre túto certifikáciu. Na podrobnosti o jednotkách možno odkazovať v záznamoch certifikácie. |
levels |
pole reťazcov | Zoznam úrovní priradených k tejto certifikácii, ktoré označujú, koľko skúseností v danej role je potrebné na pochopenie všetkých aspektov skúšok tejto certifikácie. Na podrobnosti o jednotkách možno odkazovať v záznamoch na úrovni. |
roles |
pole reťazcov | Zoznam relevantných rolí úloh pre túto certifikáciu. Na podrobnosti o rolách môžete odkazovať v záznamoch rolí. |
study_guide |
pole objektov | Zoznam priradeného obsahu na štúdium pre túto certifikáciu. Na podrobnosti o objektoch je možné odkazovať v priradených záznamoch. |
Poznámka
V tomto zázname certifikácií s odkazom na pole skúšky sa budú nachádzať certifikácie, ktoré vyžadujú viac ako jednu skúšku.
Záznamy skúšky
Každý záznam skúšky bude mať nasledujúci tvar:
{
"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"
}
]
}
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
uid |
povrázok | Jedinečný identifikátor tejto skúšky – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
title |
povrázok | Názov skúšky v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
subtitle |
povrázok | Podnadpis k skúške v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
display_name |
povrázok | Zobrazovaný názov skúšky v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
url |
povrázok | Plne kvalifikovaná URL adresa na skúšku v službe Microsoft Learn v požadovanom miestnom jazyku. |
icon_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku svg veľkosti 100 x 100, ktorý predstavuje skúšku. |
pdf_download_url |
povrázok | Plne kvalifikovaná URL adresa do PDF súboru, ktorá načrtá zručnosti merané touto skúškou. |
practice_test_url |
povrázok | Plne kvalifikovaná URL adresa praktického testu priradeného k skúške. |
practice_assessment_url |
povrázok | Plne kvalifikovaná URL adresa k hodnoteniam bezplatných postupov súvisiacich so skúškou. |
locales |
pole reťazcov | K dispozícii je zoznam jazykov, v prípade ktoré je táto skúška k dispozícii. |
type |
povrázok | Typ záznamu. Hodnotou bude vždy "skúška". |
courses |
pole reťazcov | Zoznam priradených identifikátorov U ID kurzov. Podrobnosti o kurzoch môžete odkazovať v záznamoch kurzu. |
levels |
pole reťazcov | Zoznam úrovní spojených s touto skúškou, ktoré označujú, koľko skúseností v danej úlohe je potrebné na pochopenie všetkých aspektov tejto skúšky. Na podrobnosti o jednotkách možno odkazovať v záznamoch na úrovni. |
roles |
pole reťazcov | Zoznam relevantných rolí úloh pre túto skúšku. Na podrobnosti o rolách môžete odkazovať v záznamoch rolí. |
products |
pole reťazcov | Zoznam relevantných produktov, na ktoré sa táto skúška vzťahuje. Na podrobnosti o produktoch môžete odkazovať v záznamoch produktov. |
providers |
pole objektov | Zoznam poskytovateľov tejto skúšky. Typ popisuje poskytovateľa a úplnú URL adresu s prepojením na naplánovanie skúšky u poskytovateľa. |
study_guide |
pole objektov | Zoznam súvisiaceho obsahu na štúdium tejto skúšky. Na podrobnosti o objektoch je možné odkazovať v priradených záznamoch. |
Záznamy kurzu vedeného inštruktorom
Každý záznam kurzu bude mať nasledujúci formát:
{
"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"
}
]
},
Podrobnosti poľa
| Pole | Type | Description |
|---|---|---|
uid |
povrázok | Jedinečný identifikátor tohto kurzu vedeného inštruktorom – táto hodnota bude jedinečná v rámci celej služby MS Learn. |
course_number |
povrázok | Identifikátor čísla kurzu vedeného inštruktorom. |
title |
povrázok | Názov kurzu vedeného inštruktorom v požadovanom miestnom jazyku (prípadne v americkej angličtine). |
summary |
povrázok | Reťazec, ktorý obsahuje krátky popis vedeného inštruktorom. Hodnota sa vyjadruje ako značka odseku HTML s vnútorným textom, ktorý je súhrnom. |
duration_in_hours |
celé číslo | Priemerný čas, ktorý tento kurz vedený inštruktorom trvá v hodinách. |
url |
povrázok | Plne kvalifikovaná URL adresa stránky s podrobnosťami o kurze vedeným inštruktorom v službe Microsoft Learn v požadovanom miestnom jazyku. |
icon_url |
povrázok | Plne kvalifikovaná URL adresa k obrázku SVG veľkosti 100 x 100, ktorý predstavuje úspech kurzu vedený inštruktorom. |
locales |
pole reťazcov | Tento kurz vedený inštruktorom je oficiálne k dispozícii v zozname jazykov. Ostatní jazyky môžu byť podporované partnermi v oblasti vzdelávania. |
type |
povrázok | Typ záznamu. Hodnotou bude vždy "kurz" pre kurzy vedené inštruktorom. |
certification |
povrázok | Certifikácia spojená s kurzom vedeným inštruktorom. |
exam |
povrázok | Skúška spojená s kurzom vedeným inštruktorom. |
levels |
pole reťazcov | Zoznam úrovní spojených s týmto kurzom vedeným inštruktorom, ktorý udáva, koľko skúseností v danej úlohe je potrebné na pochopenie všetkých aspektov tohto kurzu. Na podrobnosti o jednotkách možno odkazovať v záznamoch na úrovni. |
study_guide |
pole objektov | Plne kvalifikovaná URL adresa do PDF súboru, ktorá poskytuje prehľad zručností meraných touto certifikáciou. |
Záznamy úrovne, produktu, roly a predmetu
Kolekcie levels, products, rolesa subjects obsahujú popisné názvy pre hodnoty používané v údajoch modulu a študijného programu. Všetky štyri kolekcie majú rovnaký tvar:
{
"id": "unique-id",
"name": "name-of-item",
"children": [
{ "id": "unique-id", "name": "name-of-item" },
{ "id": "unique-id", "name": "name-of-item" },
...
]
}
id bude zodpovedať hodnotám úrovní, produktov, rolí a subjektov zahrnutých do iných položiek katalógu. Priradená hodnota name obsahuje správny názov položky v angličtine. Pole children je voliteľné a umožňuje hierarchické usporiadanie hodnôt, ktoré majú podriadené vzťahy, ako sú napríklad produkty.
Tu je napríklad množina možných rolí:
{
...
"roles": [
{
"id": "administrator",
"name": "Administrator"
},
{
"id": "ai-engineer",
"name": "AI Engineer"
},
{
"id": "business-analyst",
"name": "Business Analyst"
},
{
"id": "developer",
"name": "Developer"
},
...
]
}
Tu je príklad množiny produktov s podradenými položkami, ktorý poskytuje presnejšiu kategóriu produktov.
{
...
"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"
},
...
]
}
Vzorové kódy
Existuje mnoho spôsobov ako zavolať rozhranie API pre Learn Catalog, ale ukážky kódu uvedené nižšie sú príkladmi toho, ako ho možno použiť.
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 s použitím rozšírenia cURL
<?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 pomocou knižnice "requests"
#!/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)
Ďalšie kroky
Pozrite si zdroje uvedené nižšie a pomôžte vám na ceste k vývoju: