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.
Trabajo realizado: 2025
JSON directo de la base de datos al navegador
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.

Foto: Wuestensohn2000 / Pixabay 
Foto: wal_172619 / Pixabay
Aplique esta experiencia a su proyecto
Utilice «Paso directo de JSON de Postgres a la API» como punto de partida para un reto similar en su organización. Los servicios que respaldan este trabajo están disponibles para su proyecto. La estructura del sistema se define primero sobre el papel para que las piezas encajen y los costes se conozcan antes de escribir código.
Mire más allá del resultado
Lea la situación, las decisiones y el resultado de este ejemplo. Podemos hablar de qué partes se adaptan a sus restricciones y cuáles necesitan otro enfoque. Paso directo de JSON de Postgres a la API — JSON directo de la base de datos al navegador
Vuelva a ver Una plataforma marítima con límites claros entre sistemas. Lea a continuación: Cambio de contexto entre organizaciones. O eche un vistazo al Portafolio completo.
Una parte de una trayectoria más amplia — y toda ella está en este sitio.
Cada entrada sigue la misma estructura: la situación, la tarea, lo que hicimos y lo que cambió.

