Por qué el JSON construido a mano falla

Al principio construye el JSON a mano, copiando cada campo de su modelo en un dict. Parece sencillo y, para un solo endpoint, realmente lo es.

Añada algunas columnas y su dict crece línea a línea. Pronto, un modelo implica un bloque largo y frágil de pares de key-value que debe mantener sincronizados.

Los endpoints de lista y detalle reconstruyen el mismo dict. Esa duplicación significa que cambiar un nombre le obliga a editar exactamente la misma estructura en muchos lugares.

Un datetime sin procesar no es compatible con JSON, así que jsonify falla o hace suposiciones. El código manual rara vez formatea las fechas de la misma manera dos veces en toda la aplicación.

Si vuelca un modelo completo, podría enviar su password_hash o indicadores internos. El JSON construido a mano facilita demasiado la exposición de campos privados.

Un usuario con muchas publicaciones implica bucles dentro de diccionarios dentro de listas. Las estructuras anidadas convierten el código de serialización en un entramado que nadie disfruta leyendo.

El JSON construido a mano solo se ocupa de la salida. Las cargas entrantes siguen llegando sin comprobar, así que la validación se convierte en otro conjunto de instrucciones if que debe escribir manualmente.

Un schema describe sus datos una sola vez: qué campos existen, sus tipos y sus reglas. Tanto la salida como la entrada pasan después por esa única descripción.

Marshmallow es la biblioteca popular para esto en Flask. Declara una clase Schema y esta se encarga de serializar la salida y validar la entrada.

Con un esquema, la lista de campos vive en un solo lugar. Cambie el nombre o elimine un campo allí y todos los endpoints seguirán siendo coherentes automáticamente.

Cambia decenas de líneas frágiles de dict por una clase ordenada. El resultado es menos código, una salida más segura y un contrato claro para su API.

El JSON construido a mano duplica trabajo, gestiona mal las fechas y filtra secretos. Una capa de schema como Marshmallow centraliza la estructura de sus datos para obtener una salida limpia y segura.