# JSON transmis directement de Postgres à l'API

Conçu une architecture de transmission directe du JSON où les fonctions PostgreSQL renvoient des documents complets, transmis tels quels par l'API Go, supprimant la désérialisation intermédiaire et découplant le frontend des changements de schéma.

2025

Situation. Le trajet habituel des données d'une base à un navigateur ressemble à une course de relais entre transformations. La base transmet des lignes à l'API, l'API les désérialise dans des structures, les remodèle, les sérialise à nouveau en JSON et, seulement alors, les envoie. Chacun de ces relais représente du code à écrire, du code à tester et un endroit de plus où la représentation des données dans l'API peut s'écarter de celle de la base.

Tâche. L'idée était de supprimer cette course de relais. Si la base pouvait retourner la réponse achevée, l'API pourrait simplement la transmettre, et l'interface dépendre directement de la structure fournie par la base plutôt que d'une copie maintenue à la main dans Go.

Action. Le système a donc été construit comme une transmission directe. Les fonctions PostgreSQL assemblent toute la réponse en JSON — la mise en forme des données relève de SQL, là où les données se trouvent déjà. Le gestionnaire Go récupère cette réponse sous forme de json.RawMessage et la transmet sans modification ; il ne la décompose jamais et ne la réencode jamais. Un petit utilitaire QueryJSON a fait de ce schéma le chemin le plus simple, plutôt qu'une consigne à se rappeler. Toute la mécanique intermédiaire accumulée par une API conventionnelle en couches a ainsi disparu — DTO, convertisseurs, structures de réponse.

Résultat. Le code des gestionnaires s'est considérablement raccourci et, surtout, l'interface a cessé d'être couplée à Go. Une modification du retour d'une fonction se propage directement jusqu'au client, sans que personne ait à modifier une ligne du gestionnaire. Moins de pièces mobiles, et toute une catégorie de divergences entre couches qui n'existe tout simplement pas ici.

Rôle: Architecte de plateformes
=> /fr/categories/platform-architecture/ Catégories: Architecture de plateformes
=> /fr/categories/backend/ Catégories: Ingénierie backend
=> /fr/categories/api/ Catégories: API et intégration
=> /fr/categories/databases/ Catégories: Bases de données
=> /fr/categories/postgresql/ Catégories: PostgreSQL
=> /fr/categories/sql/ Catégories: SQL
=> /fr/categories/performance/ Catégories: Optimisation des performances
=> /fr/services/platform-architecture/ Prestations: Architecture de plateformes et de solutions
=> /fr/services/backend-development/ Prestations: Développement backend et API
=> /fr/services/ai-tools/ Prestations: Outils pour agents d'IA et serveurs MCP
=> /fr/services/database-design/ Prestations: Conception et modélisation de bases de données

=> https://data.engineer.company/fr/portfolio/designed-a-json-passthrough-from-postgres-to-api/ Cette page sur le Web
