Prehľad funkcií rozhrania API pre Microsoft Learn Catalog

Rozhranie API pre Microsoft Learn Catalog je webovým rozhraním API založeným na architektúre REST, umožňuje odoslať webový dotaz do služby Microsoft Learn a získať informácie o dostupnom obsahu školenia a certifikačných skúškach, ako sú napríklad tituly, produkty, na ktoré sa vzťahujú, úrovne, prepojenia na školenia a ďalšie metaúdaje a vráti odozvu kódovanú použitím JSON s informáciami.

Vráti informácie o všetkých verejne dostupných zdrojoch:

  • Moduly
  • Jednotky
  • Študijné programy
  • Použité zručnosti
  • Certifikácie
  • Skúšky
  • Kurzy vedené inštruktorom

Poznámka

V rámci najnovšej aktualizácie lokality Microsoft Learn je v learn.microsoft.com doméne k dispozícii nový koncový bod rozhrania API pre Catalog. Starý koncový bod bude naďalej fungovať podľa očakávania, ale výhody prechodu na nový koncový bod sú to, že vám poskytne vylepšené funkcie, ako napríklad ďalšie parametre dotazu.

Prípady použitia

  • Zobrazenie metaúdajov o školeniach a ponukách certifikácií na Microsoft Learn
  • Získajte zoznam ponúk školenia a/alebo certifikácie služby Microsoft Learn, aby ste ich mohli prepojiť z vášho vlastného online prostredia.

Ako funguje rozhranie API pre Katalóg Learn

Rozhranie API je webové rozhranie API založené 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/

Výstup bude vyzerať podobne ako snímka obrazovky nižšie. K novembru 2022 je úplná odpoveď približne 13 MB.

Screenshot of the Learn Catalog API output in Visual Studio Code.

Každá položka katalógu learningu je objekt s množinou metaúdajov, ktoré sú k dispozícii pre každú z nich. Úplný slovník údajov a ďalšie možnosti sú uvedené v dokumentácii pre vývojárov rozhraní API pre Microsoft Learn Catalog. Tiež máme k dispozícii poznámky k vydaniu (prepojenie), aby sme zistili, aké sú najnovšie aktualizácie, a informácie o osvedčených postupoch .

Ak ho chcete používať, pozrite si článok Začíname s rozhraním API pre Microsoft Learn Catalog pomocou cURL a Visual Studio Code.

Požiadavky

Na prístup k API pre Microsoft Learn Catalog nie je potrebné žiadne overovanie. Používatelia môžu použiť svoju preferovanú metódu rozhrania API vyžadujúcu, ako napríklad cURL, Postman atď.

Príklady

Nižšie je uvedených niekoľko spôsobov, ako používateľov vidíme pomocou rozhrania API pre Learn Catalog:

  • Viva Vzdelávanie použila rozhranie API pre Learn Catalog, aby ako súčasť svojho základného prostredia ponúkla katalóg Microsoft Learn.
  • Organizácie a vzdelávacie inštitúcie používajú rozhranie API služby Learn Catalog na vyžiadanie informácií z katalógu a ich uverejnenie vo svojich interných systémoch na správu vzdelávania (LMS), aby k nim mohli jednoducho pristupovať ich zamestnanci a študenti.
  • poskytovatelia Vzdelávanie používajú rozhranie API služby Learn Catalog na vyžiadanie informácií o katalógu a ich uverejnenie vo svojich prostrediach vzdelávania pre zákazníkov.

Dostupnosť a ceny

Rozhranie API pre Microsoft Learn Catalog je verejne dostupné a ponúkané podľa podmienok podmienok používania rozhraní API spoločnosti Microsoft. Používanie rozhrania API nie je bezplatné.

Obmedzenia

  • Rozhranie API obsahuje verejne dostupné moduly, lekcie, študijné programy, kurzy vedené inštruktorom, skúšky a certifikácie. Momentálne výstupom nie je dokumentácia, ukážky kódu, zobrazené udalosti ani udalosti.
  • Rozhranie API sa obnoví aspoň raz za deň.
  • Aktualizácie verzia rozhrania API sa oznámi prostredníctvom aktualizácií pre Poznámky k vydaniu rozhrania API pre Catalog.

Ďalšie kroky

Ďalšie informácie o rozhraní API pre Learn Catalog získate v nasledujúcich článkoch: