Antes de empezar. Ya has trabajado la evolución y el versionado de rutas en Servidor. Hoy comprobarás la compatibilidad del contrato antes de integrar un cliente.
Se explica
25 minutos · explicación y demostración
Servidor 31–32 aporta pruebas HTTP, OpenAPI y versionado. Aquí comprobamos que la documentación publicada corresponde al código y que el consumidor conoce el cambio. La especificación tiene una implementación responsable en Servidor y una versión verificable en Intermodular.
Un cambio es incompatible si una petición que funcionaba deja de tener el comportamiento acordado: renombrar un campo o envolver una lista en una página puede afectar al cliente. Que el backend compile no comprueba por sí solo ese efecto.
Se trabaja
140 minutos · trabajo guiado sobre el producto compartido
Bloque A · Capturar el contrato real
Arranca el backend actual y abre Swagger. Ejecuta una lectura y una escritura con datos ficticios. Comprueba estado y cuerpo frente a la colección. Enlaza la especificación desde la descripción del contrato de la API; corrige cualquier descripción que prometa una ruta todavía inexistente.
Bloque B · Comparar con la versión anterior
Conserva una exportación de la colección del primer trimestre. Identifica un cambio compatible y uno incompatible de la evolución prevista. Escribe qué petición lo detecta. No renombres un campo en producción para demostrar que se rompe: utiliza una rama o entorno de prueba.
Bloque C · Coordinar la transición
Aplica la estrategia implementada en Servidor 32: nueva ruta o compatibilidad temporal. Actualiza el consumidor después de que la API acepte su contrato. Mantén un caso que pruebe la ruta antigua durante el periodo acordado. Cambiar todas las URLs a la vez eliminaría esa evidencia.
Bloque D · Revisar una PR con el contrato delante
La persona revisora ejecuta la colección sobre la versión propuesta, comprueba un 400 y un 404 y localiza la prueba HTTP que protege cada caso. Si falta una aserción de implementación, la corrección corresponde al test compartido de Servidor; Intermodular verifica que ese test se ejecuta y bloquea la fusión cuando falla.
Bloque E · Identificar la versión publicable
Añade a las notas de versión cambios del contrato, consumidores comprobados, compatibilidad y pendientes. Registra SHA y ejecución CI. No declares compatible una versión verificada únicamente con el consumidor nuevo.
Cierre
15 minutos · comprobación del resultado
Al terminar la sesión: El contrato versionado está revisado con peticiones antiguas y nuevas. Las incompatibilidades y la transición están descritas y comprobadas antes de integrar el cliente.