Una guía de inicio rápido para tu integración
Queremos que tu integración comience rápidamente para que todos podamos dar acceso a nuevos mercados a nuestros clientes comunes.
A continuación se muestra la página Integraciones de Udemy Business
Pasos de los requisitos previos
- Solicitud de asociación enviada y aprobada
- Udemy ha proporcionado un entorno de sandbox para Udemy Business
- El administrador de Udemy ha invitado a usuarios adicionales
Si falta cualquiera de estos elementos, consulta la (Guía Primeros pasos) para conseguirlos en primer lugar.
Casos de integración de socios: Puedes revisar los casos de uso de alto nivel que pueden lograrse con estas instrucciones de integración. Si no, vayamos al desarrollo.
Pasos de desarrollo
Recomendamos mitigar el riesgo técnico conectando primero con todas las API de Udemy para, a continuación, comenzar el desarrollo del software cuando se haya confirmado que todos los endpoints funcionan.
- Si te conectas a la API de cursos, obtienes al menos 10 cursos.
- Si te conectas a la API del curso, obtienes al menos 1 curso.
- Inicia sesión en tu página de Udemy Business, inscríbete en un curso y visualiza una clase durante al menos un minuto (puedes incrementar la velocidad de reproducción).
- Conéctate a la API de informes (actividad de usuarios).
- Conéctate a la API de informes (actividad de usuarios en cursos).
- Conéctate a la API de informes (intento de actividad de aprendizaje).
- Inicia sesión en la página de Udemy Business y crea una Vía de aprendizaje (documentación), abre un curso y añádelo a la vía de aprendizaje que acabas de crear.
- Si te contectas a la API de vía de aprendizaje, volverás a la vía de aprendizaje que creaste.
Configuraciones
Cuando funcionen la mayoría de las API, puedes pasar a los pasos de configuración.
- La configuración del inicio de sesión único (SSO) se hace directamente dentro de tu página Configuración de Udemy Business. Necesitarás credenciales de administrador para acceder a esta configuración. Configura nuevos SSO desde cero con uno de nuestros muchos proveedores. O bien, crea una conexión personalizada con SAML 2.0. (enlace a la documentación sobre SSO).
- Revisa el resto de la configuración en [Udemy Business: Gestionar: Configuración] y personalízala como quieras.
Mejoras
Vías de aprendizaje: permite a los usuarios crear un currículum que incluye un gran variedad de recursos de aprendizaje con un punto de inicio y fin para guiar al estudiante.
- Inicia sesión en la página de Udemy Business y crea una Vía de aprendizaje (documentación), abre un curso y añádelo a la vía de aprendizaje que acabas de crear.
- Conéctate a la API de vía de aprendizaje y vuelve a la vía de aprendizaje que has creado.
- Conéctate a la API de informes (learning-path-activity).
Generación de informes en tiempo real a través de webhook
- Configurar xAPI, el webhook de Udemy para obtener datos de generación de informes sobre el progreso y la finalización de eventos del estudiante (documentación). Añadirás parámetros a la página de configuración de administrador de Udemy.
- Una vez se haya completado la configuración, visualiza una clase corta a la velocidad de reproducción máxima y comprueba si recibes los datos de progreso.
Consultar o buscar datos del curso: con la API de GraphQL de Udemy, puedes enviar consultas al catálogo de cursos que te devolverán solamente los datos que necesites para un caso de uso específico. También ofrecemos una API de búsqueda que toma tus indicaciones, aplica filtros y ofrece resultados de cursos relevantes.
- Obtener credenciales de API de GraphQL
- Llamar a la función de GraphQL GetAuthToken()
- Utilizar [authToken] para llamar a la API de cursos
- Llamar a la API de CourseSearch
Nota: Para acceder a la documentación de GraphQL, deberás iniciar sesión en Udemy Business. La URL correspondiente incluye el subdominio de la cuenta de Udemy de tu organización, seguido de .udemy.com/dev-portal/api-reference/.
Por ejemplo:
https://{tu_subdominio}.udemy.com/dev-portal/api-reference/.
Desarrollo del software principal
Cuando funcionen todas las credenciales de Udemy, estén conectadas todas las API y se hayan realizado las configuraciones adicionales, se habrá eliminado el riesgo técnico. A continuación, muchos socios pasarán a la planificación o directamente al desarrollo. Una forma de comenzar es seleccionar una lista de historias de usuarios o casos de uso compatibles y determinar las API de Udemy necesarias para cada caso de uso. A partir de aquí, mucha suerte a tu ingeniería de software.
Solución de errores, excepciones y prácticas recomendadas
Refuerza el software incorporando gestión de errores, excepciones y casos extremos. Para poder gestionar los problemas informáticos no esperados, tenemos varias recomendaciones de solución de errores.
- Registra las respuestas a errores de API.
- Añade lógica de reintento a las llamadas de API.
- Gestiona los límites de frecuencia utilizando prácticas recomendadas de tamaño de página.
- Aplica otras prácticas recomendadas descritas en el documento.
Para obtener asistencia adicional y comentarios, o al finalizar la nueva integración, ponte en contacto con nosotros en partnersupport@udemy.com. Esperamos abrir juntos nuevos mercados con nuestra nueva función conjunta.