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 con docente

Nota

È ora disponibile un nuovo set di endpoint API per l'accesso ai dati del Catalogo di Microsoft Learn, che sostituisce l'API di Learn Catalog. L'endpoint esistente documentato qui continuerà a funzionare fino alla metà del 2026, ma è pianificato per la deprecazione. È consigliabile eseguire la migrazione al nuovo endpoint per sfruttare le funzionalità avanzate, inclusi parametri di query aggiuntivi. Se si è interessati a eseguire la migrazione ai nuovi endpoint dell'API del catalogo, contattare LearnPlatformAPIMigration@microsoft.com.

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 informazioni sulle procedure consigliate .

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 del Catalogo API di Microsoft Learn.

Passaggi successivi

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

  • Last updated on