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.
| Cambio | Riesgo que probar | La expectativa debe definir |
|---|---|---|
| Campo eliminado | El receptor antiguo lo exige | Rechazo, alternativa o versión separada |
| Null en vez de ausencia | Ramas de código diferentes | Significado y presentación acordados |
| Propiedad opcional nueva | Rechazo estricto de desconocidas | Soporte real del consumidor antiguo |
| Cambio de tipo | Cálculo o representación rotos | Transición acordada, sin conversión silenciosa |
| Mismo tipo, otro significado | La validación técnica pasa | Semá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.