Najčastejšie otázky o rozhraní API pre Microsoft Learn Catalog

V tomto článku sa uvádzajú najčastejšie otázky o rozhraní API pre Microsoft Learn Catalog prostredníctvom ich odpovedí a prepojení na ďalšie informácie podľa potreby.

Všeobecné

Otázka: Koľko stojí používanie rozhrania API pre Katalóg Learn?

Používanie rozhrania API pre Katalóg Learn nie je nákladné. Ďalšie informácie nájdete v časti Dostupnosť a ceny v článku Prehľad funkcií rozhrania API pre Learn Catalog.

Otázka: Aké sú pravidlá na používanie rozhrania API pre Katalóg Learn?

Pozrite si podmienky používania rozhraní Microsoft Learn a API od spoločnosti Microsoft.

Otázka: Musím sa pridať alebo získať kľúče, aby som mohol používať rozhranie API pre Katalóg Learn?

Nie. Rozhranie API je verejne dostupné. Pozrite si článok Začíname s rozhraním API pre Learn Catalog pomocou cURL a Visual Studio Code a/alebo v článku Referenčné informácie pre vývojárov k rozhraniu API pre Learn Catalog.

Otázka: Umožní toto rozhranie API našim používateľom používať obsah Na lokalite Learn v rámci našej platformy?

Nie. Rozhranie API pre Katalóg Learn poskytuje metaúdaje o obsahu a priame prepojenia na obsah. Používatelia môžu integrovať tieto prepojenia do ľubovoľného systému LMS alebo webového prostredia v súlade s podmienkami používania rozhrania API spoločnosti Microsoft.

Otázka: Zostávajú údaje vrátené z rozhrania API pre Learn Catalog statické alebo sa zmenia?

Údaje sa menia pri každom pridaní, úprave alebo odstránení nového obsahu, čo je zvyčajne raz za deň.

Odozva rozhrania API

Otázka: Môžem chytiť všetky údaje naraz?

Áno. Na získanie úplnej odpovede použite základný koncový bod learn.microsoft.com/api/catalog. Ďalšie informácie o požiadavke rozhrania API nájdete v článku Príručka pre vývojárov rozhraní API pre Katalóg Learn .

Otázka: Môžem odpoveď vopred filtrovať?

Áno. Pozrite si filtre dotazov, ktoré sú k dispozícii v článku Referenčné informácie o rozhraniach API pre Vývojárov k Katalógu Learn.

Otázka: Sú identifikátory UID jedinečné pre každý objekt obsahu?

Áno. UID je skratka pre jedinečné ID a je jedinečná pre každý objekt obsahu. Ak sa identifikátor UID zmení, aj keď názov alebo iné metaúdaje zostanú rovnaké, obsah sa považuje za nový objekt.

Otázka: Prečo sú v súhrne modulu značky HTML?

Zvyčajne sa snažíme ponechať formátovanie súhrnu čo nespracované, ale niekedy musíme zdôrazniť alebo prepojiť určitý text.

Otázka: Prečo nie sú prepojenia na jednotlivé jednotky?

Jednotky nie sú napísané ako samostatný obsah. Ich použitie je určené na použitie v konkrétnom poradí pre modul. Z tohto dôvodu zahrnieme prepojenie na stránku s podrobnosťami o module a prvú lekciu, aby tam používatelia mohli začať a pokračovať v obsahu.

Otázka: Ako zistím, ktorý obsah je nový?

Hodnota last_modified zobrazí, kedy bol záznam naposledy upravený.

Otázka: Je pre prepojenia na obsah povolené jediné Sign-On (SSO)?

Momentálne nie. V budúcnosti sa snažíme povoliť jediné prihlásenie.

Obsah

Otázka: Je UID jedinečné pre obsah?

Áno. UID je skratka pre jedinečné ID a je jedinečná pre každý objekt obsahu. Ak sa identifikátor UID zmení, aj keď názov alebo iné metaúdaje zostanú rovnaké, obsah sa považuje za nový objekt.

Otázka: Sú všetky moduly súčasťou študijného programu?

Nie. Všetky moduly dokážu stáť sami v tom zmysle, že učia scenár alebo koncept, ktorý sa v nich môže nechať úplne od konca, a nevyžadujú prijatie predpokladov modulov. Pre niektorých je to ono a nie sú súčasťou študijného programu. Pre iných sú zoskupené v jednom alebo viacerých študijných programoch, ktoré preberajú používateľa prostredníctvom vytvárania pokročilejších konceptov. Modul nemusí byť súčasťou študijného programu alebo môže byť súčasťou jedného alebo viacerých častí.

Otázka: Ako zistím, kedy bol obsah pridaný, obnovený alebo odstránený?

Nové objekty obsahu sa v odpovedi zobrazia ako nový objekt (identifikovaný identifikátorom UID). Po úprave obsahu ho môžete určiť na základe jeho last_modified hodnoty. Po odstránení obsahu sa obsah odstráni z odpovede. Hoci sa niekedy môže mierne oneskoriť aktualizácia obsahu v odpovedi rozhrania API, keď používateľ sleduje URL adresu obsahu, vždy sa mu zobrazia najaktuálnejšie informácie. V prípade odstránenia obsahu sa stará URL adresa presmeruje na nový obsah alebo prostredie.

Ide predovšetkým o neustále aktualizovanie obsahu. Aktualizácie publikujete zvyčajne dvakrát denne. Môžu byť buď drobné, ako napríklad drobné zmeny textu, alebo hlavné, ako napríklad hlavné revízie, pridania alebo odstránenia. Vo všeobecnosti sa portfólio obsahu spravuje ako masívny, vysoko riadený open-source projekt s tisíckami prispievateľov, a preto sa zmeny dejú neustále. Ak používate rozhranie API pre Katalóg Learn v produkčnom systéme, mali by ste sa oboznámiť s tým, ako funguje tvorba verzií obsahu, a nechať váš systém, aby ho mohol spracovať.

Otázka: Ako získam prístup k dokumentácii, videu a vzorovým katalógom kódu?

Prístup k týmto katalógom sa momentálne nedá získať pomocou programovania. Cieľom je v budúcnosti umožniť programový prístup k týmto katalógom.

Lokalizácia

Otázka: Aké jazyky sú k dispozícii v službe Microsoft Learn?

V službe Microsoft Learn je k dispozícii viac ako 65 miestnych nastavení. Úplný zoznam môžete vidieť tu prostredníctvom päty lokality (vyberte jazyk, ktorý si prezeráte na úplný zoznam).

Otázka: Je obsah k dispozícii v iných jazykoch?

To závisí od rôznych faktorov. Chceme sprístupniť obsah vo všetkých jazykoch, v ktorých sú výrobky vyučované v obsahu. Ak študent prejde na lokalitu Microsoft Learn v určitom miestnom prostredí, ak obsah nie je v tomto miestnom nastavení k dispozícii, používateľovi sa zobrazí hlavička a päta v požadovanom miestnom prostredí a základný obsah sa predvolene vráti do angličtiny, kým nebude k dispozícii lokalizovaná verzia.

Otázka: Líši sa obsah pre daný objekt obsahu v závislosti od jazyka, v akom jazyku ho zobrazujete?

Možno. Keď sú aktualizácie publikované v anglickom obsahu, naše lokalizované kanály budú fungovať na to, aby sa lokalizované verzie aktualizovali čo najskôr – zvyčajne v priebehu niekoľkých dní od pôvodnej zmeny.

Iné

Otázka: Existuje rozhranie API na vytváranie zostáv alebo funkcie na získavanie údajov, ako sú zobrazenia, kliknutia, dokončenie?

Momentálne nemáme rozhranie API na vytváranie zostáv. Máme k dispozícii funkcie na vytváranie zostáv organizácie , ktoré umožňujú organizáciám vykonávať zostavy o dokončeniach používateľov.

Ďalšie kroky

Ďalšie informácie o rozhraní API pre Katalóg Learn získate na nasledujúcich prepojeniach: