Riepilogo delle API disponibili

Le API di Udemy Business forniscono diverse funzionalità di integrazione per garantire una maggiore flessibilità nello sviluppo del software.  In questo articolo sono illustrati alcuni dei potenziali utilizzi di ciascuna API e suggerimenti su quale scegliere.

Indice

Corsi e strumenti di apprendimento

API GraphQL dei corsi - protocollo: GraphQL

  • La nuova generazione e l'evoluzione delle API tradizionali dei corsi. In GraphQL, per ogni corso, vengono restituiti solo i metadati del corso specificato. Inoltre, utilizzando il sistema di query di GraphQL, vengono restituiti i corsi che corrispondono ai criteri specificati. 

Nota: per saperne di più sulla tecnologia generale alla base di GraphQL, visita la pagina di GraphQL.

API GraphQL degli strumenti di apprendimento - Protocollo: GraphQL 

  • Oltre ai corsi, Udemy offre numerosi strumenti di apprendimento.  Ogni strumento di apprendimento può essere richiamato tramite API per essere integrato nel sistema.  Questa API restituisce corsi, labs e badge.  Come per gli altri servizi GraphQL, puoi utilizzare le query per ottenere solo gli strumenti e i campi specificati.

Documentazione: per consultare la documentazione relativa a GraphQL, è necessario avere accesso a Udemy Business. Visualizza il portale degli sviluppatori all'indirizzo https://{your_subdomain}.udemy.com/dev-portal/api-reference/

Reportistica

API di reportistica - protocollo: RESTful 

  • Questa API contiene tutti i dati dell'utente raccolti su progressi, completamenti e azioni legati al suo percorso di apprendimento.  Puoi scegliere se ottenere i dati di reportistica di tutti gli utenti o se specificare un insieme di utenti. A causa della quantità di dati, può esserci un ritardo tra la raccolta delle azioni degli utenti e la loro pubblicazione nei report.

Documentazione: documentazione API Udemy Business - API RESTful

xAPI - protocollo: xAPI

  • Reportistica in tempo reale, restituita tramite webhook, realizzata secondo gli standard xAPI EdTech.  Udemy consente di ottenere i dati relativi ai progressi e alla reportistica in tempo reale.  I dati contenuti in questi eventi in tempo reale hanno una portata minore rispetto alle API di reportistica RESTful.

Documentazione: documentazione xAPI Udemy Business

Percorsi di apprendimento

API dei percorsi di apprendimento - protocollo: RESTful 

  • Udemy consente agli studenti e agli amministratori in apprendimento e sviluppo (L&D) di creare percorsi di apprendimento, una raccolta di diversi corsi e qualsiasi altro tipo di strumento di apprendimento, compresi link esterni. È possibile richiamarli tramite API restituendo tutti i percorsi e gli elementi in essi contenuti.

Documentazione: documentazione API Udemy Business - API RESTful

Single Sign-On (SSO)

Udemy Business è in grado di connettersi a tutti i servizi Single Sign-On SAML 2.0, che includono la maggior parte dei provider SSO. Inoltre, sono disponibili integrazioni SSO personalizzate, purché rispettino lo standard SAML 2.0.

Protocollo: SAML 2.0+

Documentazione: Panoramica del SSO di Udemy Business e delle sue funzioni principali

API SCIM per il provisioning degli utenti - Il provisioning SCIM (System for Cross-domain Identity Management) consente di effettuare il provisioning e il deprovisioning delle licenze degli utenti. Questo sistema consente ai team IT o alle integrazioni personalizzate di automatizzare le funzioni di gestione delle licenze.

Protocollo: SCIM

Documentazione: ​​Provisioning SCIM (System for Cross-domain Identity Management)

API legacy dei corsi 

API dei corsi - protocollo: RESTful 

  • L'API dei corsi segue le tradizionali norme EdTech. Ottiene tutti i metadati dei corsi per un singolo corso o per tutti i corsi.

Nota bene: trattandosi di un'API legacy, non rilasceremo alcuna nuova funzionalità per questa API dei corsi.  Tutte le nuove funzionalità saranno rilasciate per le API GraphQL che, oltre ai corsi, includono tutti gli strumenti di apprendimento.

Documentazione: documentazione API Udemy Business - API RESTful

Migliore integrazione consigliata

Ogni cliente e partner di Udemy è differente e può avere esigenze diverse. Per ottenere la migliore integrazione possibile, consigliamo di incorporare le seguenti API:

1. Corsi e strumenti di apprendimento: utilizza l'API GraphQL per avere accesso a tutti gli strumenti di apprendimento

2. Reportistica: utilizza l'API REST per avere accesso all'intera gamma di dati e completala con l'xAPI per i dati in tempo reale

3. SSO: consigliamo l'utilizzo insieme a SCIM per automatizzare il provisioning e il deprovisioning degli utenti

4. Percorsi di apprendimento: utilizza l'API dei percorsi di apprendimento per consentire agli amministratori L&D e ai responsabili dei programmi di creare percorsi di apprendimento per l'utente finale.

Articoli correlati

Contattaci