Llevar JSON a sistemas reales: cómo definir contratos de API, cómo gestionar configuración y fixtures, cómo manejar la compatibilidad de versiones y cómo mantener los datos de prueba.
5 artículosSeis cosas son muy difíciles de cambiar una vez publicadas: los envoltorios de respuesta, los formatos de error, la forma de la paginación, la representación de IDs y tiempo, la semántica de null frente a ausente, y la evolución de versiones.
La configuración debe estar por capas y validada; los fixtures deben ser deterministas, legibles y comparables con diff. Si estos dos tipos de archivos se gestionan mal, el coste de diagnóstico se mantiene alto durante mucho tiempo.
Cincuenta registros se convierten en cincuenta y uno y el diff informa cincuenta y un cambios. Cubre los falsos positivos del diff de texto, la correspondencia de arrays por id, la normalización con jq y los parches aplicables.
merge=union deja pasar JSON roto y aun así informa éxito. Recorre un driver de merge a tres bandas consciente de las claves para JSON, más tres hábitos que reducen los conflictos.
Añadir un campo no es automáticamente seguro. Cubre los límites de compatibilidad, los campos de versión, las ventanas de deprecación, la migración con escritura dual, las pruebas de contrato y las métricas de canary.
