Огляд функцій API каталогу Microsoft Learn
API каталогу Microsoft Learn – це веб-інтерфейс API на основі REST, який дає змогу надсилати веб-запит до Microsoft Learn і повертати відомості про доступний навчальний вміст і сертифікаційні іспити, наприклад назви, продукти, що охоплюються, рівні, посилання на навчальні курси та інші метадані та повертає відповідь із кодом JSON з інформацією.
Повертає відомості про всі загальнодоступні:
- Модулі
- Одиниць
- Навчальні шляхи
- Застосовані навички
- Сертифікати
- Іспити
- Instructor-Led курси
Примітка
У рамках останнього оновлення сайту Microsoft Learn в домені learn.microsoft.com доступна нова кінцева точка API каталогу. Стара кінцева точка працюватиме належним чином, але перевагами переходу на нову кінцеву точку є те, що вона дасть вам розширені функції, наприклад додаткові параметри запиту.
Інциденти використання
- Перегляд метаданих про навчальні курси та/або сертифікаційні пропозиції Microsoft Learn
- Оформіть список навчальних курсів і/або сертифікаційних пропозицій Microsoft Learn, щоб створити посилання на них із власного онлайнового інтерфейсу
Принцип роботи API каталогу Learn
API – це веб-інтерфейс API на основі REST, який повертає відповідь у кодуванні JSON. Щоб надіслати запит на повний каталог, надішліть запит GET:
https://learn.microsoft.com/api/catalog/
Результат буде схожий на знімок екрана нижче. Станом на листопад 2022 року повна відповідь становить приблизно 13 МБ.
Кожен елемент навчального каталогу – це об'єкт із набором метаданих, доступним для кожного з них. Повний словник даних та інші параметри наведено в документації розробника API каталогу Microsoft Learn. Крім того, у нас є нотатки про випуск (посилання), щоб дізнатися, що таке останні оновлення, і практичні поради інформацію.
Якщо ви зацікавлені в його використанні, перегляньте Початок роботи з API каталогу Microsoft Learn за допомогою cURL і Visual Studio Code статті.
Вимоги
Немає автентифікації, необхідної для доступу до API каталогу Microsoft Learn. Користувачі можуть використовувати основний метод запиту API, наприклад CURL, Postman тощо.
Приклади
Нижче наведено кілька способів, якими ми бачимо користувачів, які використовують API каталогу Learn:
- Viva Learning використовує API каталогу Learn, щоб запропонувати каталог Microsoft Learn як частину свого основного досвіду.
- Організації та навчальні заклади використовують API каталогу Learn, щоб отримувати відомості про каталог і розміщувати їх у своїх системах внутрішнього навчання (LMS), щоб їхні співробітники та учні могли легко отримати до неї доступ.
- Постачальники навчальних послуг використовують API каталогу Learn, щоб отримувати відомості про каталог і публікувати їх у своїх навчальних програмах для клієнтів.
Доступність і ціни
API каталогу Microsoft Learn доступний у відкритому доступі та пропонується на умовах умови використання API microsoft. Використовувати API не стягується.
Обмеження
- API містить загальнодоступні модулі, підрозділи, навчальні шляхи, курси під керівництвом інструктора, іспити та сертифікації. Наразі вона не дає змогу виводити документацію, зразки коду, покази або події.
- API оновлюється принаймні один раз на день.
- Оновлення версії API буде повідомлено за допомогою оновлень Learn Catalog API Release Notes.
Наступні кроки
Щоб дізнатися більше про API каталогу Learn, перегляньте такі статті: