Calendario de versiones
Descubre nuestra estrategia de versiones y esquema de desarrollo.
Esquema de desarrollo
La innovación consiste en mantenerte a la vanguardia. Por eso mismo hemos diseñado Rapid 3, para que estés siempre un paso por delante.
Con Rapid 3 y nuestro esquema de desarrollo, podrás disfrutar de las nuevas funciones desde el momento en que estén disponibles, sin tener que esperar seis meses para su lanzamiento ni pasarte horas actualizando cada nueva versión.
Los lanzamientos de nuevas funciones no interrumpirán tu integración, por lo que podrás seguir usando Rapid 3 durante más tiempo, y así ahorrar tiempo y dinero. También te avisaremos cuando vayamos a lanzarlas, para que así puedas organizarte con antelación.
Estrategia de versiones
Cuando lancemos funciones de mayor envergadura o cambios importantes, lo haremos también en una nueva versión, por ejemplo, Rapid 4.
Nuestros equipos tecnológicos de Rapid API mantendrán una versión activa de la API mientras otra se encuentra en desarrollo. Cuando lancemos la última versión, pasará a estar activa y marcaremos la versión anterior como obsoleta. La versión obsoleta estará disponible durante un año antes de que la retiremos, por lo que tendrás tiempo suficiente para pasarte a la última que hayamos creado. Durante este periodo, solo aplicaremos arreglos de seguridad importantes a la versión obsoleta.
Terminología
Te dejamos algunas definiciones que te ayudarán a entender nuestro esquema de versiones:
Activa: la versión activa y actual de Rapid API. Las funciones que suponen cambios no disruptivos pueden añadirse a una versión activa en cualquier momento, y tú decides si integrarlas o no.
En desarrollo: la nueva versión de Rapid en la que estamos trabajando.
Obsoleta: cuando una versión se marca como obsoleta, significa que dejará de estar disponible después de un año. Se trata de un buen momento para actualizar a la última versión activa.
Retirada: una vez que se retira una versión, dejará de estar disponible a través de la API.
Cambios no disruptivos: los cambios no disruptivos son funciones que pueden añadirse a una versión activa en cualquier momento y no interrumpirán tu integración.
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 enum de respuesta con un valor predeterminado
Cambios disruptivos: estos cambios son actualizaciones de características de más envergadura que pueden interrumpir tu integración. Solo publicaremos cambios disruptivos en las nuevas versiones activas de Rapid para que no tengas que preocuparte de la integración existente.
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