Leggere in inglese

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 tutti i contenuti disponibili pubblicamente:

  • Moduli
  • Insieme unità misura
  • Percorsi di apprendimento
  • Competenze applicate
  • Certificazioni
  • Esami
  • Corsi con docente

Nota

Nell'ambito del recente aggiornamento del sito Microsoft Learn, è disponibile un nuovo endpoint dell'API Catalogo nel dominio learn.microsoft.com. L'endpoint precedente continuerà a funzionare come previsto, ma il passaggio al nuovo endpoint ha il vantaggio di rendere disponibili diverse funzionalità avanzate, come 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 del Catalogo API di Microsoft Learn

L'API è un'API Web basata su REST che restituisce una risposta con codifica JSON. Per richiedere il catalogo completo, invia 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 of the Learn Catalog API output 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'APIcatalogo 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 si è interessati a usarlo, vedere l'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 il Catalogo API di Microsoft Learn:

  • Viva Learning ha usato il Catalogo API di Microsoft Learn per offrire il catalogo di Microsoft Learn come parte dell'esperienza principale.
  • Le organizzazioni e gli istituti didattici usano il Catalogo API di Microsoft Learn 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 il Catalogo API di Microsoft Learn per eseguire il pull delle informazioni sul catalogo e pubblicarlo nelle esperienze di apprendimento dei clienti.

Disponibilità e prezzi

L'API catalogo di Microsoft Learn è disponibile pubblicamente e offerta in base al termine delle Condizioni per l'utilizzo delle API Microsoft. Non è previsto alcun addebito per l'uso dell'API.

Limiti

  • 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 sul Catalogo API di Microsoft Learn, vedere gli articoli seguenti: