Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Acest articol listează întrebările frecvente despre API-ul Catalog Microsoft Learn, cu răspunsurile și linkurile la mai multe informații, după cum este necesar.
General
Q: Cât costă să utilizeze API-ul Learn Catalog?
Nu există niciun cost pentru a utiliza API-ul de catalog Learn. Pentru mai multe informații, consultați secțiunea Disponibilitate și prețuri din articolul Prezentare generală a caracteristicii API a catalogului.
Î: Care sunt regulile pentru utilizarea API-ului de catalog Learn?
Consultați Microsoft Learn și Condițiile de utilizare a API-ului Microsoft.
Î: Trebuie să înscriu sau să obțin chei pentru a utiliza API-ul de catalog Learn?
Nu. API-ul este disponibil public. Consultați articolul Introducere în api-ul Learn Catalog utilizând articolul cURL și Visual Studio Code și/sau articolul Referințe pentru dezvoltatorii api din catalogul learn.
Î: Această interfață API le va permite utilizatorilor noștri să consume conținutul Learn din platforma noastră?
Nu. API-ul Learn Catalog oferă metadate despre conținut și linkuri directe la conținut. Utilizatorii pot integra aceste linkuri în orice experiență web sau sistem de gestionare a învățării (LMS), în conformitate cu Condițiile de utilizare Microsoft API.
Q: Datele returnate din API-ul de catalog Learn rămân statice sau modificate?
Datele se modifică de fiecare dată când se adaugă, se modifică sau se șterge conținut nou, care este de obicei zilnic.
Răspuns API
Q: Pot să iau toate datele deodată?
Da. Utilizați punctul final de bază, learn.microsoft.com/api/catalog pentru a obține răspunsul complet. Consultați articolul Informații despre referințele api-ului catalogului pentru mai multe informații despre solicitarea API-ului.
Î: Pot pre-filtra răspunsul?
Da. Consultați filtrele de interogare disponibile în articolul Referințe pentru api-uri pentru api-uri de catalog.
Î: UID-urile sunt unice pentru fiecare obiect de conținut?
Da. UID înseamnă "ID unic" și este unic pentru fiecare obiect de conținut. Dacă un UID se modifică, chiar dacă titlul sau alte metadate rămân neschimbate, conținutul este considerat un obiect nou.
Q: De ce există etichete HTML în rezumatul modulului?
De obicei, încercăm să menținem formatarea rezumatului cât mai brut posibil, dar uneori trebuie să accentuăm sau să legăm un anumit text.
Q: De ce nu există legături pentru unitățile individuale?
Unitățile nu sunt scrise ca conținut independent. Acestea sunt destinate să fie luate într-o anumită ordine pentru modul. Din acest motiv, includem linkul la pagina de detalii a modulului și la prima unitate, astfel încât utilizatorii să poată începe de acolo și să treacă prin conținut.
Î: Cum aflu ce conținut este nou?
Valoarea last_modified vă spune când s-a modificat ultima dată înregistrarea.
Q: Este activat un singur Sign-On (SSO) pentru linkurile de conținut?
Nu în acest moment. Dorim să permitem SSO în viitor.
Conținut
Q: UID-ul este unic pentru conținut?
Da. UID înseamnă "ID unic" și este unic pentru fiecare obiect de conținut. Dacă un UID se modifică, chiar dacă titlul sau alte metadate rămân neschimbate, conținutul este considerat un obiect nou.
Q: Toate modulele fac parte dintr-o cale de învățare?
Nu. Modulele sunt capabile să stea singur, în sensul că predau un scenariu sau un concept end-to-end în cadrul lor și nu necesită luarea modulelor preliminare. Pentru unii, aceasta este și acestea nu fac parte dintr-o cale de învățare. Pentru alții, acestea sunt grupate într-una sau mai multe căi de învățare care îi fac unui utilizator să construiască concepte mai complexe. Un modul nu trebuie să facă parte dintr-o cale de învățare sau poate fi o parte a unuia sau mai multora.
Î: Cum știu când a fost adăugat, reîmprospătat sau șters conținutul?
Atunci când sunt adăugate obiecte de conținut noi, acestea apar ca obiect nou (identificat de UID) ca răspuns. Când conținutul este modificat, vă puteți spune pe baza valorii sale de last_modified. Când conținutul este șters, obiectul de conținut este eliminat din răspuns. Deși uneori există o ușoară întârziere a actualizării conținutului în răspunsul API, atunci când un utilizator urmează URL-ul la conținut, acesta vede întotdeauna cele mai recente informații. Atunci când conținutul este șters, vechiul URL va redirecționa către conținutul sau experiența nouă sau la următoarea opțiune optimă.
În special, conținutul este în curs de actualizare tot timpul. Publicăm actualizările disponibile de două ori pe zi. Acestea pot fi minore, cum ar fi modificări minore de text sau majore, cum ar fi revizuiri majore, adăugiri sau ștergeri. În general, portofoliul de conținut este gestionat ca un proiect masiv, foarte guvernat open-source cu mii de colaboratori, și, ca atare, modificările se întâmplă tot timpul. Dacă utilizați API-ul Learn Catalog în sistemul de producție, ar trebui să știți acest lucru și să aveți sistemul în măsură să îl gestioneze.
Î: Am urmărit un link cu marcaj în document la conținut, dar acum îmi arată un alt fragment de conținut decât mă așteptam. De ce?
Ne străduim să ne asigurăm că nimeni nu ajunge la un punct mort (404) cu link-uri la site-ul nostru. Atunci când conținutul este modificat sau înlocuit, implementăm o redirecționare pentru linkul vechi care vă va duce automat la conținutul nou. În cazul în care conținutul este perimat și nu este înlocuit din diverse motive, vom redirecționa la următorul conținut cel mai potrivit, care poate fi un domeniu ușor modificat sau la o pagină de destinație etc.
Î: Cum obțin acces la documentație, videoclipuri și cataloage eșantion de cod?
Nu există nicio modalitate programatică în acest moment pentru a obține acces la aceste cataloage. Dorim să permitem accesul programatic la aceste cataloage în viitor.
Localizare
Î: Ce limbi sunt disponibile în Microsoft Learn?
Există peste 65 de setări regionale disponibile în Microsoft Learn. Puteți vedea o listă completă aici prin intermediul subsolului site-ului (selectați limba pe care o vizualizați pentru a vedea lista completă).
Î: Conținutul este disponibil în alte limbi?
Depinde. Dorim să punem la dispoziție conținutul în toate limbile în care sunt disponibile produsele predate în conținut. Atunci când elevii vizitează site-ul Microsoft Learn într-o anumită setare regională, dacă conținutul nu este disponibil în setările regionale respective, utilizatorul vede antetul și subsolul în setările regionale dorite, iar conținutul de bază revine la engleză până când este disponibilă o versiune localizată.
Î: Conținutul este diferit pentru un anumit obiect de conținut, în funcție de limba în care îl vizualizați?
Posibil. Atunci când actualizările sunt publicate în conținutul în limba engleză, canalizările noastre de localizare funcționează pentru a actualiza versiunile localizate cât mai curând posibil - de obicei, în câteva zile de la modificarea inițială.
Alt
Q: Există api-uri sau funcționalități de raportare pentru a obține date cum ar fi vizualizări, clicuri, finalizare?
Momentan nu avem un API de raportare. Avem funcționalitate de raportare organizațională care le permite organizațiilor să raporteze despre finalizările utilizatorilor lor.
Pașii următori
Puteți afla mai multe despre API-ul Pentru catalogul Learn, vizitând următoarele linkuri: