Calendario de versiones

Obtén más información sobre nuestra estrategia de esquema de desarrollo y versiones para la API de información sobre reservas.

Esquema de desarrollo

En el vertiginoso mundo de la tecnología, mantenerse a la vanguardia es fundamental. Por este motivo, nuestra API de análisis está diseñada para seguir el ritmo de tus necesidades. Con nuestro esquema de desarrollo, recibes nuevas funciones en el momento justo en que se desarrollan. Ya no tendrás que esperar a una nueva versión ni enfrentarte a los engorrosos procesos de actualización.

Nuestras funciones más recientes se han diseñado para integrarse a la perfección y garantizar que sigas utilizando la versión actual sin interrupciones. Así ahorrarás tiempo y dinero. Nosotros te mantendremos al día de las próximas funciones, para que puedas planificarlas con eficacia.

Estrategia de versiones

Para actualizaciones o cambios significativos que puedan afectar a las integraciones existentes, introducimos versiones nuevas, como la API de análisis v2.

Nuestro equipo de API gestiona una versión activa mientras desarrolla la siguiente. Al lanzar una nueva versión, esta se convierte en la versión activa y la precedente entra en una fase de obsolescencia. Las versiones obsoletas siguen estando disponibles durante un año, para que tengas tiempo suficiente de realizar la transición. Durante este periodo, solo se realizan actualizaciones de seguridad críticas en la versión obsoleta.

Terminología

Comprender nuestro calendario de versiones es más fácil con la siguiente lista de definiciones:

Activa: la versión actual de la API de análisis, a la que se añaden cambios y funciones no disruptivas. Dispondrás de la flexibilidad necesaria para integrar estas funciones como prefieras.

Desarrollo: la próxima versión de la API en desarrollo.

Obsolescencia: una versión marcada como obsoleta indica que se eliminará al cabo de un año. Este periodo es el idóneo para poder actualizar a la última versión activa.

Retirada: una versión retirada ya no es accesible a través de la API.

Cambios no disruptivos: actualizaciones que pueden integrarse sin afectar a la configuración que tienes en ese momento. Incluyen adiciones como nuevos puntos de conexión, parámetros de consulta opcionales y campos de respuesta, entre otros.

Entre los cambios no disruptivos se incluyen:

Nuevos puntos finales
Nuevos parámetros de consulta opcionales
Nuevos campos de solicitud opcionales en los cuerpos de solicitud
Nuevos encabezados opcionales en la solicitud
Parámetros de solicitud obligatorios que pasan a ser opcionales
Nuevos campos en una respuesta
Nuevos encabezados en las respuestas
Nuevos valores en una enum de solicitud
Nuevos valores en una respuesta enum con un valor predeterminado.

Cambios disruptivos: actualizaciones importantes que pueden requerir cambios en la integración que ya tienes. Estos incluyen la eliminación de puntos de conexión, la introducción de nuevos parámetros obligatorios y cambios en las configuraciones de verificación, entre otros. Los cambios disruptivos solo se introducen en las nuevas versiones activas de la API.

Entre los cambios disruptivos se incluyen:

Puntos de conexión eliminados
Nuevos parámetros de consulta obligatorios
Nuevos campos de solicitud obligatorios en los cuerpos de solicitud
Nuevos encabezados obligatorios en la solicitud
Parámetros de solicitud opcionales ahora obligatorios
Parámetros de consulta eliminados o con otro nombre
Campos de respuesta eliminados o con otro nombre
Tipo de parámetros de consulta cambiado
Tipo de campos de solicitud cambiados en el cuerpo de una solicitud
Nuevos requisitos de validación en parámetros existentes
Configuraciones de verificación o autorización eliminadas
Valores de enum eliminados o con otro nombre
Nuevos valores en una enum de respuesta con un valor no predeterminado