{"canonical_url":"https://engineer.company/uk/glossary/backend/","content_markdown":"# Бекенд\n\n## Що це таке\n\nБекенд — це частина програмної системи, яка працює на машинах під контролем її оператора: він\nзберігає дані, застосовує правила про те, кому що дозволено, і відповідає на запити від браузерів,\nзастосунків та інших сервісів. Англійською його також пишуть back end або back-end, а ту саму\nтериторію часто називають серверною стороною, server side.\n\nУ термінах HTTP бекенд — це те, що RFC 9110 називає origin server: програма, яка може створювати\nавторитетні відповіді для певного цільового ресурсу. Документ W3C Architecture of the World Wide Web\nдодає погляд читача. URI ідентифікує ресурс, а до браузера вирушає його представлення, дані, що\nкодують інформацію про стан ресурсу. Клієнт бачить сторінку замовлення, а бекенд зберігає\nзамовлення, залишки на складі й оплату та вирішує, що потрапить у відповідь.\n\nЗазвичай бекенд надає API, набір HTTP-ендпоінтів, які може викликати фронтенд, мобільний застосунок\nабо система іншої компанії. API — це контракт: які шляхи існують, що приймає кожен із них, що\nповертає і які помилки може видати. OpenAPI Specification — поширений спосіб записати цей контракт у\nвигляді опису, незалежного від мови програмування, з якого інструменти генерують клієнти,\nдокументацію й тести. За API робота зазвичай поділена на шари: обробку запитів, бізнес-логіку й\nзберігання.\n\n## Чому це важливо\n\nПерше питання — чи потрібен системі взагалі бекенд, що працює в момент запиту. Сторінку, однакову\nдля кожного відвідувача, можна згенерувати один раз і віддавати як файли. Бекенд, що працює\nпостійно, виправдовує себе, коли запит має щось змінити або залежить від того, хто його надіслав:\nзамовлення, вхід в обліковий запис, пошук у приватних даних. До того ж він коштує грошей щодня, бо\nпрограму, яка відповідає на запити з інтернету, треба захищати, оновлювати й оплачувати.\n\nДруге — довіра. Бекенд працює на машинах, які контролює оператор, тому саме там правило можна\nсправді забезпечити. Будь-яку перевірку у фронтенді обійде той, хто надсилає запити напряму, тож\nкожне важливе правило, від ціни до дозволу, перевіряють на сервері щодо користувача, який увійшов, і\nконкретного запису. OWASP Application Security Verification Standard перетворює це на вимоги, за\nякими команда може будувати й тестувати.\n\nТретє — де живе логіка. Правило, розкидане між обробником, сервісним класом і тригером у базі даних,\nмає три місця для змін і три копії, які розходяться. Одні команди тримають правила в коді\nзастосунку, а базу використовують для зберігання; інші переносять правила й формування даних у базу\nі тримають API тонким. Працювати може і те, і те, якщо кожне правило має один дім.\n\nЧетверте — контракт із клієнтами. HTTP дає кожній відповіді код стану з визначеним значенням, і\nклієнти, проксі та інструменти моніторингу діють відповідно до нього. Код 422 Unprocessable Content\nозначає, що запит синтаксично правильний і в підтримуваному форматі, але семантично хибний, як-от\nбронювання з датою в минулому. RFC 9457 додає стандартний формат для помилок, problem details:\nневеликий об'єкт JSON із полями type, title, status, detail та instance, що надсилається як\n`application/problem+json`, щоб клієнт розрізняв помилки без розбору тексту.\n\n## Як це виглядає на практиці\n\nБекенд однієї платформи\n[доручає базі даних будувати кожну відповідь і передає її без змін](/uk/portfolio/designed-a-json-passthrough-from-postgres-to-api/).\nЗвичний шлях від бази до браузера сторінка називає естафетою перетворень: API розбирає рядки у\nструктури, перекроює їх і знову серіалізує в JSON. Тут функції PostgreSQL збирають усю відповідь як\nJSON там, де вже лежать дані, а обробник на Go отримує її як `json.RawMessage` і пересилає далі як\nє. Невелика допоміжна функція `QueryJSON` зробила цей шлях найпростішим. DTO, мапери й структури\nвідповідей зникли, код обробників став значно коротшим, а зміна в тому, що повертає функція,\nдоходить до клієнта напряму, і правити код обробника не доводиться.\n\nДля вхідних запитів та сама ідея одного джерела означає, що\n[контракт починається з бази даних і поширюється назовні](/uk/portfolio/generated-the-api-contract-from-the-database-out/).\nСхема та її функції задають структури даних, типи Go задають API, Huma генерує з них опис OpenAPI, а\nз цього опису генерується типізований клієнт TypeScript на 44 076 рядків. Обмеження, які інтерфейс\nзастосовує до форми, беруться з того самого джерела, і вручну їх у валідатор ніхто не переносить.\nКожен перехід охороняється, тож поле не може змінитися лише з одного боку: розбіжність ламає\nзбирання за кілька хвилин після зміни. Ціна, яку називає сторінка, — крок генерації в самому центрі\nпроцесу.\n\nНа задокументованому етапі проєктування цей сайт обрав протилежний підхід. Він\n[повністю генерувався під час збирання й не потребував бекенду застосунку для обробки запитів](/uk/portfolio/built-a-multilingual-hugo-site-in-3-languages/).\nЧотири вимоги, зокрема робота трьома мовами й відсутність окремо оплачуваного\nсервісу застосунку, привели до цього вибору: такий бекенд довелося б захищати,\nоновлювати й описувати на сторінці про конфіденційність. Окрім зафіксованого\nобмеженого винятку JavaScript для фільтра портфоліо, інтерактивні функції\nпотрібно було реалізовувати під час збирання або не додавати. Це опис\nзадокументованого етапу проєктування, а не нинішнього складу чи реалізації сайту;\nвін не означає, що хостинг був безкоштовним.\n\n## Де виникають проблеми\n\nЗбої бекенду зазвичай мовчать, доки не надійде запит, якого ніхто не передбачив.\n\n**Користувач змінює запис, що належить комусь іншому.** Ендпоінт перевіряє, що той, хто викликає,\nувійшов, а потім завантажує будь-який ID, названий в URL, тож достатньо змінити в запиті\n`/invoices/1041` на `/invoices/1042`. Власність або дозвіл треба перевіряти на сервері для кожного\nоб'єкта, якого торкається запит, в одному місці, крізь яке проходить кожен обробник, і мати тест, що\nпросить запис іншого облікового запису й очікує 403 або 404.\n\n**Дія виконується двічі.** Посилання, що скасовує щось через GET-запит, відкриває краулер або\nбраузер, який завантажує сторінки наперед, і дія відбувається без жодного кліку. RFC 9110 визначає\nGET, HEAD, OPTIONS і TRACE як безпечні (safe) методи саме для того, щоб пошукові роботи й попереднє завантаження могли\nпрацювати без ризику завдати шкоди. Інший шлях — повторна спроба: платіжний запит перевищує час\nочікування, клієнт надсилає його знову, і покупець платить двічі. Кожну зміну стану варто ставити за\nPOST, PUT, PATCH або DELETE, а записам, які можуть повторитися, давати ключ, який сервер пам'ятає,\nщоб друга копія повертала результат першої.\n\n**Кожна помилка повертається як 500 або як 200 із повідомленням про помилку всередині.** Один\nуніверсальний обробник повідомляє про всі збої однаково, тож моніторинг рахує друкарські помилки як\nаварії, а логіка повторних спроб повторює запити, які щоразу завершаться помилкою. Кожен збій варто\nзіставити з кодом стану, що його описує: 400 або 422 для поганого введення, 401 і 403 для\nідентичності й дозволів, 404 для відсутнього ресурсу, 409 для конфлікту і 5xx лише для власних збоїв\nсервера. Подробиці надсилають як problem details:\n\n```json\n{\n    \"type\": \"https://example.com/problems/booking-in-past\",\n    \"title\": \"Booking date is in the past\",\n    \"status\": 422,\n    \"detail\": \"The date 2026-10-01 is before today.\",\n    \"instance\": \"/bookings/8812\"\n}\n```\n\nRFC 9457 зазначає, що problem details не є інструментом налагодження базової реалізації, тому\nстектрейси й SQL залишаються в журналах сервера.\n\n**Сторінки сповільнюються з ростом даних.** Обробник завантажує список замовлень, а потім для\nкожного окремим запитом отримує дані клієнта, тож сторінка з 50 замовлень робить 51 звернення до бази даних. У\nрозробці з десятьма рядками це здається швидким, а в продакшні з десятьма тисячами гальмує.\nПов'язані дані варто отримувати одним запитом із join або доручити базі зібрати всю відповідь, і\nстежити за кількістю звернень до бази на один запит так само уважно, як за часом відповіді.\n\n## Що почитати далі\n\n- [Architecture of the World Wide Web, Volume One](https://www.w3.org/TR/webarch/) — рекомендація\n  W3C про ресурси, представлення та безпечні й небезпечні взаємодії.\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) — стандарт IETF про методи,\n  коди стану і те, що робить запит безпечним або ідемпотентним.\n- [OpenAPI Specification](https://spec.openapis.org/oas/latest.html) — незалежний від мови формат\n  опису HTTP API, який читають і люди, і генератори коду.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457) — стандартна\n  форма JSON для машинозчитуваних відповідей про помилки.\n- [OWASP Application Security Verification Standard](https://owasp.org/projects/asvs) — перелік\n  вимог безпеки для створення й тестування вебзастосунків.\n\n\u003chttps://engineer.company/uk/glossary/backend/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що робить бекенд, коли сайту він узагалі потрібен, де мають жити бізнес-правила і де HTTP API на серверній стороні найчастіше ламаються.","formats":{"gemtext":"https://engineer.company/uk/glossary/backend/index.gmi","gopher":"https://engineer.company/uk/glossary/backend/gophermap","html":"https://engineer.company/uk/glossary/backend/","json":"https://engineer.company/uk/glossary/backend/index.json","markdown":"https://engineer.company/uk/glossary/backend/index.md","pdf":"https://engineer.company/uk/glossary/backend/index.pdf"},"kind":"page","language":"uk","title":"Що таке бекенд?","url":"https://engineer.company/uk/glossary/backend/","version":1}