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
- Acuerdos legales firmados
- Entorno de disposiciones de Udemy para Udemy Business
- Invitación de inicio de sesión de Udemy
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).
- Configuración de xAPI OPCIONAL: Webhook de Udemy para ofrecer datos sobre el progreso de los estudiantes y los eventos de contenidos completados (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.
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.
Prácticas recomendadas de API de Udemy Business
- 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.