{"canonical_url":"https://engineer.company/uk/glossary/http/","content_markdown":"# HTTP\n\n## Що це таке\n\nHTTP, або Hypertext Transfer Protocol, — це набір правил, за якими браузер,\nзастосунок чи скрипт просить у сервера щось і отримує відповідь; коли ця розмова\nйде всередині зашифрованого з'єднання TLS, той самий протокол називають HTTPS.\nКожен обмін складається з двох половин. Клієнт надсилає запит: метод на кшталт\n`GET` чи `POST`, ціль, яку хоче отримати, набір полів заголовка і часом тіло.\nСервер відповідає тризначним кодом стану, власними полями заголовка й, зазвичай,\nтілом. Завантаження сторінки, отримання зображення, виклик однієї програми з\nіншої — це один і той самий обмін, повторений багато разів.\n\n```http\nGET /pricing/ HTTP/1.1\nHost: example.com\nAccept: text/html\n\nHTTP/1.1 200 OK\nContent-Type: text/html; charset=utf-8\nCache-Control: max-age=600\n```\n\nСпецифікація називає HTTP протоколом без стану. Кожен запит мусить нести все,\nщо потрібно серверу, щоб його зрозуміти, а сам протокол нічого не пам'ятає між\nобмінами. Вхід до облікового запису, кошик і сесії будують поверх нього,\nздебільшого на cookie: це поле заголовка, яке сервер встановлює один раз, а\nклієнт повертає з кожним наступним запитом.\n\nСловник у HTTP невеликий, зате точний. `GET` і `HEAD` — безпечні методи: вони\nпросять представлення ресурсу й нічого не мають змінювати. `PUT` та `DELETE`\nідемпотентні, тобто той самий запит, надісланий двічі, лишає сервер у тому ж\nстані, що й надісланий один раз. `POST` не обіцяє ні того, ні іншого. Коди стану\nзгруповано за першою цифрою: 2xx означає успіх, 3xx — перенаправлення, 4xx —\nпроблему із запитом, 5xx — проблему на сервері. Тож клієнт, який бачить\nнезнайомий код, усе одно приблизно розуміє, що сталося.\n\nЗначення всіх цих слів лишається сталим, хоча формат передавання вже двічі\nзамінили. HTTP/1.1 пише повідомлення текстовими рядками поверх з'єднання TCP, і\nкожне з'єднання повертає відповіді по одній, у порядку запитів. HTTP/2 зберігає\nті самі методи й поля, але пакує їх у двійкові кадри та переплітає багато\nзапитів в одному з'єднанні. HTTP/3 передає ту саму семантику через QUIC, транспорт\nна основі UDP, який усуває властиве TCP транспортне блокування початку черги\nміж незалежними потоками. Від\n2022 року IETF публікує семантику в одному документі, а формат кожної версії —\nв окремому, тож запитання «що означає 404» і «як розміщені байти» тепер мають\nокремі відповіді.\n\nОтже, HTTP чи HTTPS — це вибір не між двома протоколами. HTTPS — це HTTP, під\nяким лежить TLS: він шифрує обмін і підтверджує ім'я сервера. WebSocket\nпочинається як звичайний запит HTTP, а потім перемикає з'єднання на канал, де\nписати можуть обидві сторони. gRPC — це домовленість про віддалені виклики, що\nпрацює поверх HTTP/2.\n\n## Чому це важливо\n\nМайже кожна система, яка спілкується з іншими через інтернет, уже говорить\nHTTP. Тому справжнє питання інше: користуватися тим, що протокол визначає, чи\nсприймати його як трубу й будувати решту самотужки.\n\nНа користь першого варіанта є вагомий аргумент: довгий ланцюжок програм уже\nрозуміє цей словник. Клієнтська бібліотека може повторити `GET`, на який не\nдочекалася відповіді, але `POST` мусить лишити як є, і так само має вчинити\nбудь-який проксі посередині. Кеш може зберігати відповідь із позначкою\n`max-age=600` десять хвилин і віддавати її наступному читачеві, не питаючи\nсервер. Моніторинг зараховує відповіді 5xx до помилок без додаткових підказок. API,\nщо надсилає кожен виклик як `POST` на одну адресу й повідомляє про збій усередині\nвідповіді 200, усього цього позбавляється, і кожен клієнт мусить вивчати його\nприватні правила.\n\nУ моделі є межі. Запит і відповідь добре пасують клієнтові, який знає, чого\nхоче, і значно гірше — серверу, якому є що повідомити першим. Через це живі\nоновлення зазвичай ідуть через WebSocket, server-sent events або регулярні\nповторні запити.\n\nЗ відкритим HTTP у публічному інтернеті відповідь коротка. Браузери позначають\nйого як небезпечний, будь-хто на шляху може прочитати й змінити вміст, а\nсертифікати безкоштовні, тож публічний трафік має йти через HTTPS. Вибір між\nHTTP/1.1, HTTP/2 і HTTP/3 — здебільшого налаштування сервера або периферії\nперед ним. Код застосунку лишається тим самим, бо кожен запит означає те саме в\nусіх трьох версіях.\n\n## Як це виглядає на практиці\n\nНайвиразніший приклад на цьому сайті — API, яке перенесли на фреймворк,\nпобудований довкола самої форми HTTP.\n[HTTP API переїхало з Fiber на Huma v2](/uk/portfolio/migrated-the-api-to-huma-v2-at-100-parity/),\nщо працює поверх Fiber. Кожен ендпоінт оголошено через структури входу й\nвиходу, і валідація випливає з типів, а не з написаних уручну перевірок. З тих\nсамих оголошень виходить опис OpenAPI, а перевірка в CI порівнює маршрути, які\nреєструє сервер, з тими, що їх декларує опис. На 649 шляхах із 760 операціями\nпаритет становить 100%, і він тримається, бо маршрут без опису завалює білд.\nРівно два ендпоінти лишилися на чистому Fiber — ті, що працюють через\nWebSocket, де модель запиту й відповіді Huma не підходить.\n\nСам сайт використовує узгодження вмісту. Кожну сторінку опубліковано і як HTML,\nі як Markdown, і один зі способів отримати Markdown — це\n[надіслати `Accept: text/markdown` і дати серверу вибрати](/uk/cli/). Та сама\nсторінка пояснює, чому адреса onion навмисно має звичайний `http://`: адреса кодує\nвідкритий ключ сервісу, тож Tor автентифікує сервіс і шифрує канал ще до\nпершого запиту HTTP.\n\nHTTP трапляється і як інструмент в інфраструктурному коді. Коли розгортали\nдругий сервер,\n[налаштування брандмауерів обох провайдерів написали безпосередньо для їхніх REST API](/uk/portfolio/provisioned-a-second-server-from-code/)\nчерез узагальнене HTTP-завдання, а не через колекцію постачальника. Так зникла\nзалежність разом з її версійним дрейфом, а платою стало ручне написання форми\nкожного запиту. Сторінка називає й іншу ціну: узагальнене HTTP-завдання не\nоголошує підтримки режиму перевірки, тож пробний прогін сценарію Ansible, який створює\nмашину, пропускає в ньому кожне завдання. Тому перевірку проводять на сценарії\nналаштування брандмауера.\n\n## Де виникають проблеми\n\nБільшість помилок із HTTP з'являється тоді, коли слово з його словника\nвживають в іншому значенні, ніж те, яке чує решта ланцюжка.\n\n### Помилка, що виглядає як успіх\n\nAPI відповідає кодом 200 і кладе в тіло `\"error\": \"card declined\"`. Кеш може\nтаку відповідь зберегти, дашборди зараховують її як успіх, а логіка повторних\nспроб у клієнті так і не спрацьовує. Надсилайте код, який відповідає ситуації,\n4xx або 5xx, а суть проблеми описуйте в тілі. RFC 9457 визначає для цього\nформат JSON із типом `application/problem+json`.\n\n### Посилання, яке видаляє\n\nЗапит `GET` змінює стан, наприклад посилання для відписки чи видалення в\nлисті. Пошукові роботи, попередній перегляд посилань у месенджерах, сканери\nбезпеки й попереднє завантаження в браузері переходять за посиланнями самі, і\nкожен із них може запустити дію. Усе, що змінює дані, має стояти за `POST`,\n`PUT` або `DELETE`, а якщо посилання таки потрібне, — за сторінкою\nпідтвердження.\n\n### Платіж, списаний двічі\n\nКлієнт надсилає `POST`, з'єднання обривається до того, як прийшла відповідь, і\nклієнт пробує ще раз. Сервер тим часом уже обробив перший запит. HTTP не дає\nклієнтові способу розрізнити ці два випадки, тож це має робити API: приймати\nключ ідемпотентності в полі заголовка й повертати збережений результат, коли\nключ повторюється, або дозволити клієнтові самому вибрати ідентифікатор нового\nресурсу і створити його через `PUT`.\n\n### Форма, що перетворюється на GET\n\nСервер відповідає на `POST` кодом 301 або 302, щоб відправити його деінде. З\nісторичних причин специфікація дозволяє агентові користувача змінити метод на\n`GET` саме для цих двох кодів, і багато хто так робить, тож тіло губиться\nдорогою. Якщо метод має пережити перенаправлення, потрібні коди 307 чи 308.\n\n### Чужа версія з кешу\n\nОдна URL-адреса віддає HTML або Markdown, українською чи англійською, залежно\nвід полів заголовка запиту. Кеш, якому про це не сказали, зберігає ту версію,\nяку побачив першою, і віддає її наступному читачеві. Відповідь мусить назвати\nполя, від яких залежить, наприклад `Vary: Accept`, щоб кеш тримав окрему копію\nдля кожного варіанта, а не одну на всю адресу.\n\n## Що почитати далі\n\n- [RFC 9110: HTTP Semantics](https://www.rfc-editor.org/rfc/rfc9110) — методи,\n  коди стану й поля заголовка, визначені один раз для всіх версій.\n- [RFC 9111: HTTP Caching](https://www.rfc-editor.org/rfc/rfc9111) — коли\n  збережену відповідь можна використати повторно і що кешу каже `Cache-Control`.\n- [RFC 9112: HTTP/1.1](https://www.rfc-editor.org/rfc/rfc9112) — текстовий\n  формат передавання, з'єднання і межі повідомлень.\n- [RFC 9113: HTTP/2](https://www.rfc-editor.org/rfc/rfc9113) — двійкові кадри\n  й багато потоків в одному з'єднанні.\n- [RFC 9114: HTTP/3](https://www.rfc-editor.org/rfc/rfc9114) — та сама\n  семантика поверх потоків QUIC.\n- [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457)\n  — стандартне тіло JSON для опису того, що пішло не так.\n\n\u003chttps://engineer.company/uk/glossary/http/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як працює HTTP: методи, коди стану й заголовки, чим відрізняються HTTP/2 та HTTP/3 і п'ять помилок, які API повторюють найчастіше.","formats":{"gemtext":"https://engineer.company/uk/glossary/http/index.gmi","gopher":"https://engineer.company/uk/glossary/http/gophermap","html":"https://engineer.company/uk/glossary/http/","json":"https://engineer.company/uk/glossary/http/index.json","markdown":"https://engineer.company/uk/glossary/http/index.md","pdf":"https://engineer.company/uk/glossary/http/index.pdf"},"kind":"page","language":"uk","title":"Що таке HTTP?","url":"https://engineer.company/uk/glossary/http/","version":1}