imbahub
Menú +
ES
Hablemos
IMBAHUB / Guías y conocimiento

Prueba el cambio con quien todavía utiliza el contrato anterior.

Una respuesta nueva que funciona puede romper un canal antiguo. Revisa significado, validación y presentación real de cada consumidor afectado. Usa ejemplos ficticios y versiones guardadas del contrato en un entorno de pruebas.

Tres controles del mismo cambio
  1. Forma

    Tipos y campos obligatorios siguen el contrato.

  2. Significado

    Unidad, idioma e interpretación siguen siendo correctos.

  3. Consumidor

    Versiones antigua y nueva dan resultados acordados.

El mismo tipo puede contener un cambio semántico que rompe compatibilidad.

El número 60 es válido, pero pasó de minutos a horas. ¿Basta el esquema?

No. El cambio de significado debe gestionarse y probarse en los consumidores aunque el tipo permanezca.

Guarda contrato y versión del consumidor

Enumera receptores del campo y versiones que ejecutan. Registra nombre, tipo, condiciones obligatorias y significado actuales. Cambiar una etiqueta editorial del CMS no equivale necesariamente a cambiar el campo de la API.

En un curso ficticio, duration podría ser un número de minutos. Sustituirlo por el texto media jornada cambia tipo y significado. Un receptor que ordena numéricamente necesita un plan aunque el texto funcione en una vista nueva.

Prueba forma y significado por separado

Selecciona valor intacto, campo ausente, texto vacío, null y propiedad adicional. Añade un tipo erróneo y un cambio semántico que conserve el tipo. Define expectativas antes de que el receptor lea las respuestas.

Los esquemas ayudan con tipos y obligatoriedad, pero necesitan reglas y ajustes del validador correctos. No deciden si un número representa minutos u horas. Revisa idiomas, referencias y presentación también.

CambioRiesgo que probarLa expectativa debe definir
Campo eliminadoEl receptor antiguo lo exigeRechazo, alternativa o versión separada
Null en vez de ausenciaRamas de código diferentesSignificado y presentación acordados
Propiedad opcional nuevaRechazo estricto de desconocidasSoporte real del consumidor antiguo
Cambio de tipoCálculo o representación rotosTransición acordada, sin conversión silenciosa
Mismo tipo, otro significadoLa validación técnica pasaSemántica conservada o contrato separado

Ejecuta consumidores antiguos y nuevos

Después del esquema prueba el recorrido real: obtener, leer y presentar o calcular lo pertinente. Incluye texto largo, otro idioma y referencias ausentes cuando el modelo lo requiera.

Registra combinaciones de contrato y consumidor que funcionan. La compatibilidad anterior no promete soporte para cualquier receptor futuro. Una transición que rompe algo necesita migración acordada o soporte paralelo durante un periodo definido.

Haz trazables el cambio y la reversión

Decide quién actualiza cada receptor y qué evidencia se exige antes de cambiar la entrega. Conserva contrato anterior, respuestas ficticias representativas y una vía acordada de reversión. No uses registros privados reales en regresiones.

Repite la matriz tras el cambio contra la versión servida realmente. Documenta receptores antiguos pendientes, retirada del soporte y responsables. Un número de versión no impide por sí solo enviar la respuesta equivocada a un canal antiguo.

Fuentes y documentación

Preguntas frecuentes

¿Toda ampliación es compatible con versiones anteriores?

No. Depende de cómo los consumidores manejan propiedades desconocidas y cambios de significado.

¿Un JSON válido demuestra que funciona el cambio?

No. Sintaxis, esquema y funcionamiento real son controles distintos.

IMBAHUB

¿Qué quieres conseguir?

Elige un cambio de campo y pruébalo con un consumidor antiguo sin modificar y con la versión nueva.

Hablemos
Interfaz del producto configurada en español, en un entorno aislado con contenido de demostración ficticio en español.

Interfaz del producto configurada en español, en un entorno aislado con contenido de demostración ficticio en español.