Condividi tramite


Panoramica delle funzionalità dell'API catalogo di Microsoft Learn

L'API catalogo di Microsoft Learn è un'API Web basata su REST consente di inviare una query basata sul Web a Microsoft Learn e di ottenere informazioni dettagliate sui contenuti di formazione disponibili e sugli esami di certificazione, ad esempio titoli, prodotti coperti, livelli, collegamenti a training e altri metadati e restituisce una risposta con codifica JSON con le informazioni.

Restituisce informazioni su tutte le informazioni disponibili pubblicamente:

  • Moduli
  • Unità
  • Percorsi di apprendimento
  • Competenze applicate
  • Certificazioni
  • Esami
  • corsi Instructor-Led

Nota

Nell'ambito dell'aggiornamento recente del sito di Microsoft Learn è disponibile un nuovo endpoint API catalogo nel dominio learn.microsoft.com. L'endpoint precedente funzionerà comunque come previsto, ma i vantaggi del passaggio al nuovo endpoint sono che offrono funzionalità avanzate, ad esempio parametri di query aggiuntivi.

Casi d'uso

  • Visualizzare i metadati sulle offerte di formazione e/o certificazione di Microsoft Learn
  • Eseguire il pull di un elenco delle offerte di formazione e/o certificazione di Microsoft Learn per collegarle dalla propria esperienza online

Funzionamento dell'API Learn Catalog

L'API è un'API Web basata su REST che restituisce una risposta con codifica JSON. Per richiedere il catalogo completo, inviare una richiesta GET a:

https://learn.microsoft.com/api/catalog/

L'output sarà simile allo screenshot seguente. A partire da novembre 2022, la risposta completa è circa 13 MB.

Screenshot dell'output dell'API Learn Catalog in Visual Studio Code.

Ogni elemento del catalogo di apprendimento è un oggetto, con un set di metadati disponibili per ognuno di essi. Il dizionario dati completo e altre opzioni sono elencate nella documentazione per sviluppatori dell'API del Catalogo di Microsoft Learn . Sono disponibili anche note sulla versione (collegamento) per vedere quali sono gli aggiornamenti più recenti e le procedure consigliate informazioni.

Se sei interessato a usarlo, dai un'occhiata all'articolo Introduzione all'API del catalogo di Microsoft Learn con cURL e Visual Studio Code.

Requisiti

Non è necessaria alcuna autenticazione per accedere all'API del catalogo di Microsoft Learn. Gli utenti possono usare il metodo di richiesta api preferito, ad esempio cURL, Postman e così via.

Esempi

Di seguito sono riportati alcuni dei molti modi in cui vengono visualizzati gli utenti che usano l'API del catalogo learn:

  • Viva Learning ha usato l'API del catalogo learn per offrire il catalogo di Microsoft Learn come parte dell'esperienza principale.
  • Le organizzazioni e gli istituti didattici usano l'API Learn Catalog per eseguire il pull delle informazioni del catalogo e pubblicarla nei sistemi di gestione di apprendimento interni (LMS), in modo che i dipendenti e gli studenti possano accedervi facilmente.
  • I provider di apprendimento usano l'API Learn Catalog per eseguire il pull delle informazioni sul catalogo e pubblicarlo nelle esperienze di apprendimento dei clienti.

Disponibilità e prezzi

L'API del catalogo di Microsoft Learn è disponibile pubblicamente e viene offerta secondo i termini dei Termini di Utilizzo delle API Microsoft . Non è previsto alcun addebito per l'uso dell'API.

Limitazioni

  • L'API contiene moduli, unità, percorsi di apprendimento, corsi con docente, esami e certificazioni disponibili pubblicamente. Non restituisce documentazione, esempi di codice, mostra o eventi in questo momento.
  • L'API viene aggiornata almeno una volta al giorno.
  • Gli aggiornamenti alla versione dell'API verranno comunicati tramite aggiornamenti alle note sulla versione dell'API Learn Catalog.

Passaggi successivi

Per altre informazioni sull'API Learn Catalog, vedere gli articoli seguenti: