Las API de Udemy Business ofrecen funcionalidades de integración mediante diferentes métodos, para que goces de una mayor flexibilidad a la hora de desarrollar tu software. En este artículo, se incluyen algunos usos posibles para cada una de ellas, así como recomendaciones sobre cuál elegir.
Índice
- Cursos y otros objetos de aprendizaje
- Informes
- Vías de aprendizaje
- Inicio de sesión único (SSO)
- Legacy Courses API
- Integración más recomendada
Cursos y otros objetos de aprendizaje
API de cursos de GraphQL - Protocolo: GraphQL
- La nueva generación y el siguiente paso en las API de cursos tradicionales. En GraphQL, te permitimos obtener solo los metadatos del curso que especifiques. Además, podemos enviar los cursos que se ajusten a los criterios que especifiques gracias al sistema de consultas de GraphQL.
Nota: Para obtener más información sobre la tecnología general que utiliza GraphQL, visita la página de GraphQL.
API de objetos de aprendizaje de GraphQL - Protocolo: GraphQL
- Además de los cursos, Udemy ofrece diferentes formas de aprender. Exponemos todos los objetos de aprendizaje mediante la API para integrarlos en tu sistema. Esta API te permite obtener cursos, laboratorios o insignias. Al igual que con otros servicios de GraphQL, puedes utilizar consultas para obtener solo los objetos y los campos que especifiques.
Documentación: Debes tener acceso a Udemy Business para obtener la documentación de GraphQL. Accede al portal del desarrollador a través de esta URL: https://{tu_subdominio}.udemy.com/dev-portal/api-reference/
Informes
API de informes - Protocolo: RESTful
- Esta API contiene todos los datos del usuario recopilados sobre el progreso, las finalizaciones y las acciones dentro del aprendizaje. Si quieres, puedes obtener los datos de informes de todos los usuarios o especificar un conjunto de usuarios. Debido al volumen de los datos, hay un retraso en las acciones de los usuarios que se recopilan y se incluyen en los informes.
Documentación: Documentación de API de Udemy Business - API RESTful
xAPI - Protocolo: xAPI
- Generación de informes en tiempo real que se proporciona a través de un webhook y se recopila siguiendo los estándares de tecnología de la educación de xAPI. Udemy permite enviarte los datos sobre informes y el progreso en tiempo real conforme vayan ocurriendo. Los datos que se incluyen en estos eventos en tiempo real tienen menos alcance que los datos de la API RESTful de informes.
Documentación: Documentación de xAPI de Udemy Business
Vías de aprendizaje
API de vía de aprendizaje - Protocolo: RESTful
- Udemy permite a los estudiantes y los administradores del aprendizaje y el desarrollo crear vías de aprendizaje, colecciones de cursos y cualquier tipo de objeto de aprendizaje (o incluso enlaces externos). Utilizamos la API para exponer estas vías de aprendizaje y devolver todas las vías y los elementos que contienen.
Documentación: Documentación de API de Udemy Business - API RESTful
Inicio de sesión único (SSO)
Udemy Business puede conectarse con cualquier servicio de inicio de sesión único basado en SAML 2.0, lo que incluye a la mayoría de los proveedores de SSO. Además, existe la opción de crear integraciones de SSO personalizadas (siempre que sigan el estándar SAML 2.0).
Protocolo: SAML 2.0+
Documentación: Descripción general del SSO de Udemy Business y sus principales funciones
API de aprovisionamiento de usuarios de SCIM - El aprovisionamiento de System for Cross-domain Identity Management (sistema de gestión de identidades entre dominios) o SCIM te permite aprovisionar y desaprovisionar licencias de usuario. Este sistema permite que los equipos de TI o las integraciones personalizadas automaticen las funciones de gestión de licencias.
Protocolo: SCIM
Documentación: Aprovisionamiento de System for Cross-domain Identity Management (SCIM)
Legacy Courses API
API de cursos - Protocolo: RESTful
- La API de cursos sigue normas tradicionales de la tecnología de la educación. Obtiene todos los metadatos de un único curso o de todos los cursos.
Nota: Esta es nuestra API de cursos heredada, por lo que no lanzaremos ninguna nueva funcionalidad para ella. Todas las nuevas funciones se lanzarán en nuestra API de GraphQL, que además de cursos, también incluye otros objetos de aprendizaje.
Documentación: Documentación de API de Udemy Business - API RESTful
Integración más recomendada
Sabemos que cada cliente y socio de Udemy es diferente y que puede tener distintas necesidades. Para obtener una integración óptima, recomendamos incorporar las siguientes API:
1. Cursos y objetos de aprendizaje: utiliza la API de GraphQL para acceder a todos los objetos de aprendizaje.
2. Informes: utiliza la API de REST para abarcar todos los datos y compleméntala con xAPI para obtener datos en tiempo real.
3. SSO: utilízalo junto a SCIM para automatizar el aprovisionamiento y el desaprovisionamiento de usuarios.
4. Vías de aprendizaje: utiliza la API de vía de aprendizaje para permitir que los administradores del aprendizaje y el desarrollo y los encargados del programa creen vías de aprendizaje para los usuarios finales.