Paso directo de JSON de Postgres a la API
Diseñé una arquitectura de paso directo de JSON en la que las
funciones PostgreSQL devuelven documentos JSON completos que la API
en Go transmite sin cambios, eliminando la deserialización
intermedia y desacoplando la interfaz de los cambios del esquema.
2025

Situación. El recorrido habitual de los datos desde una base de
datos hasta un navegador es una carrera de relevos de
transformaciones. La base de datos entrega filas a la API, la API
las deserializa en estructuras, las reorganiza, vuelve a
serializarlas como JSON y solo entonces las envía. Cada uno de esos
pasos es código que hay que escribir, código que hay que probar y
otro punto donde la idea que la API tiene de los datos puede
separarse de la que tiene la base de datos.

Tarea. La idea era saltarse la carrera de relevos. Si la base de
datos podía devolver la respuesta terminada, la API podía limitarse
a transmitirla, y el frontend podía depender directamente de la
estructura de la base de datos en lugar de una copia de ella
mantenida a mano en Go.

Acción. Por eso se construyó como un paso directo. Las funciones
PostgreSQL preparan toda la respuesta como JSON — darle forma es
responsabilidad de SQL y se hace donde ya están los datos. El
controlador Go la recibe como json.RawMessage y la reenvía intacta;
nunca la descompone ni la vuelve a codificar. Un pequeño auxiliar
QueryJSON convirtió ese patrón en la opción más fácil, en lugar de
algo que hubiera que acordarse de hacer. Desapareció toda la
maquinaria intermedia que acumula una API convencional por capas —
los DTO, los mapeadores y las estructuras de respuesta.

Resultado. El código de los controladores se redujo drásticamente y,
lo que es más relevante, el frontend dejó de estar acoplado a Go. Si
cambia lo que devuelve una función, la nueva estructura llega
directamente al cliente sin que nadie modifique una línea del
controlador. Hay menos piezas móviles, y aquí sencillamente no
existe toda una categoría de divergencias entre capas.

Categorías:
1Arquitectura de plataformas	/es/categories/platform-architecture/	software.engineer.company	70
1Ingeniería de backend	/es/categories/backend/	software.engineer.company	70
1API e integración	/es/categories/api/	software.engineer.company	70
1Bases de datos	/es/categories/databases/	software.engineer.company	70
1PostgreSQL	/es/categories/postgresql/	software.engineer.company	70
1SQL	/es/categories/sql/	software.engineer.company	70
1Optimización del rendimiento	/es/categories/performance/	software.engineer.company	70

Servicios:
1Arquitectura de plataformas y soluciones	/es/services/platform-architecture/	software.engineer.company	70
1Desarrollo de backend y API	/es/services/backend-development/	software.engineer.company	70
1Herramientas para agentes de IA y servidores MCP	/es/services/ai-tools/	software.engineer.company	70
1Diseño y modelado de bases de datos	/es/services/database-design/	software.engineer.company	70

hEsta página en la web	URL:https://software.engineer.company/es/portfolio/designed-a-json-passthrough-from-postgres-to-api/	software.engineer.company	70
