{"canonical_url":"https://engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/","content_markdown":"# Спроєктувала наскрізний JSON від Postgres до API\n\nСпроєктувала архітектуру наскрізної передачі JSON, у якій функції PostgreSQL повертають повний JSON, що дослівно пересилається через Go API, усунувши проміжну десеріалізацію (unmarshalling) та унезалежнивши фронтенд від змін схеми.\n\n2025\n\n**Ситуація.** Звичний шлях даних від бази до браузера — це естафета перетворень. База даних віддає API рядки, API десеріалізує їх у структури, перекомпоновує, знову серіалізує в JSON, і лише тоді дані вирушають далі. Кожен такий перехід — це код, який треба написати, код, який треба протестувати, і ще одне місце, де уявлення API про дані та уявлення про них бази даних можуть розійтися.\n\n**Завдання.** Ідея полягала в тому, щоб обійтися без естафети. Якби база даних повертала готову відповідь, API міг би просто передавати її далі, а фронтенд залежав би безпосередньо від форми даних у базі, а не від підтримуваної вручну копії цієї форми в Go.\n\n**Дія.** Тож систему побудовано як пряму передачу. Функції PostgreSQL збирають усю відповідь у JSON — формувати її є справою SQL, і відбувається це там, де вже лежать дані. Обробник на Go отримує її як json.RawMessage і пересилає без змін; він ніколи не розбирає її на частини й ніколи не перекодовує. Невелика допоміжна функція QueryJSON зробила цей патерн шляхом найменшого опору, а не тим, про що треба щоразу пам'ятати. Відпала вся проміжна машинерія, якою зазвичай обростає класичний багаторівневий API, — DTO, мапери, структури відповідей.\n\n**Результат.** Код обробників різко скоротився, а головне — фронтенд перестав бути прив'язаним до Go. Досить змінити те, що повертає функція, і нова форма даних доходить просто до клієнта, а в коді обробників не треба правити жодного рядка. Менше рухомих частин, а цілого класу розбіжностей між рівнями тут просто немає.\n\n---\n\n- Роль: Архітектор платформи\n- Категорії: [Архітектура платформи](https://software.engineer.company/uk/categories/platform-architecture/), [Backend‑розробка](https://software.engineer.company/uk/categories/backend/), [API та інтеграції](https://software.engineer.company/uk/categories/api/), [Бази даних](https://software.engineer.company/uk/categories/databases/), [PostgreSQL](https://software.engineer.company/uk/categories/postgresql/), [SQL](https://software.engineer.company/uk/categories/sql/), [Оптимізація продуктивності](https://software.engineer.company/uk/categories/performance/)\n- Послуги: [Архітектура платформи та рішень](https://software.engineer.company/uk/services/platform-architecture/), [Backend- та API‑розробка](https://software.engineer.company/uk/services/backend-development/), [Інструменти ШІ‑агентів та MCP‑сервери](https://software.engineer.company/uk/services/ai-tools/), [Проєктування та моделювання баз даних](https://software.engineer.company/uk/services/database-design/)\n\n\u003chttps://engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Код обробників різко скоротився, а головне — фронтенд перестав бути прив'язаним до Go. Досить змінити те, що повертає функція, і нова форма даних доходить…","formats":{"gemtext":"https://software.engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/index.gmi","gopher":"https://software.engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/gophermap","html":"https://software.engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/","json":"https://software.engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/index.json","markdown":"https://software.engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/index.md","pdf":"https://software.engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/index.pdf"},"kind":"page","language":"uk","title":"Спроєктувала наскрізний JSON від Postgres до API","url":"https://software.engineer.company/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/","version":1}