Presentación
Se ha establecido el final de la vida útil del conjunto de API 6.9 de Docebo para el 31 de julio de 2019. Hasta entonces, las API estarán totalmente disponibles para su uso y seguirán funcionando hasta el final de su vida útil. El conjunto de API 6.9 se va a reemplazar por conjunto nuevo y mejorado de API compatible con la mayoría de las funciones anteriores. En este artículo te contamos todo lo que necesitas saber respecto a la transición desde el conjunto de API 6.9 al de API 7.0. Para más información sobre nuestras API, consulta esta documentación.
¿En qué consiste el cambio?
Ahora mismo, puedes utilizar las bibliotecas API 6.9 que se hay aquí https:///api/docs#. A partir de junio de 2018, los puntos finales de Docebo con API 6.9 ya no se usarán en Docebo. El final de la vida útil de los puntos finales API 6.9 se ha establecido para el 31 de julio de 2019, por lo que cualquier punto final API 6.9 que utilice tus desarrolladores deberá cambiarse por las bibliotecas API 7.0 de Docebo antes de dicha fecha. Puedes encontrar en tu plataforma la versión 7 del navegador API si accedes a https:///api-browser/
¿Por qué vamos a retirar el conjunto de API 6.9?
A medida que la plataforma Docebo ha ido evolucionando, ha sido necesario refactorizar el conjunto de API para ofrecer un rendimiento mejor y más flexibilidad en los puntos finales disponibles. A medida que construimos el conjunto de API 7.0, es necesario ir retirando gradualmente el conjunto de API 6.9.
¿Qué tengo que hacer?
Actualiza tus integraciones para usar los puntos finales de las API que encontrarás en https:///api-browser/. También deberás revisar la documentación de las API para verificar que los métodos de autenticación estén configurados correctamente para el conjunto de API 7.0.
¿Qué pasa si no lo hago?
A partir del 31 de julio de 2019, las API 6.9 dejarán de funcionar y las llamadas a las API darán lugar a un «Error 404 (página no encontrada)», lo que provocará que fallen los puntos de integración que hayas programado para que usen los puntos finales API 6.9.
¿Qué pasa si no hay un punto final API 7.x que coincida con las API 6.9 que estoy usando?
En estos momentos estamos inmersos en el desarrollo de recursos que nos permitirán ofrecer total cobertura para los puntos finales API 6.9 dentro de la versión 7 del conjunto de API. Muchos de los puntos finales más utilizados ya están implementados para 7.0. Entretanto, seguimos trabajando para desarrollar los puntos finales restantes y planeamos completar esta tarea en los próximos meses. Docebo continuará trabajando para que haya una cobertura total de las API 6.9 y se reserva el derecho de actualizar la fecha de final de la vida útil según sea necesario, en función de nuestro programa de desarrollo.
¿Dónde puedo encontrar más información?
Si tienes alguna pregunta, puedes enviar una consulta al Servicio de Atención al Cliente de Docebo a través del Centro de Ayuda de tu plataforma.
¿Qué puntos finales 7.0 coinciden con mis puntos finales 6.9?
Docebo ha procurado que los puntos finales entre ambos conjuntos de API sean lo más parecidos posible y que, al mismo tiempo, se ajusten mejor que antes a los estándares REST. Estas son las diferencias principales entre los puntos finales de los conjuntos:
- Cambios en los parámetros que se incrustan en la URL (los parámetros POST obligatorios que son el ID del elemento que se manipula se han incrustado en la URL de la llamada).
- Cambio del formato de respuesta
Como recordatorio, puedes encontrar la documentación antigua de las API en la URL 6.9: [lmsURL]/api/docs#. Por su parte, la nueva documentación de las API está en la URL 7.0: [lmsURL]/api-browser. Consulta la siguiente tabla para ver una lista de los puntos finales antiguos y de los puntos finales nuevos correspondientes: