Начало работы
HTTP-запрос и ответ
HTTP — протокол «запрос-ответ». Клиенты отправляют запросы (метод, путь, заголовки, необязательное тело), серверы отвечают статусом, заголовками и телом. HTTP/1.1 текстовый, HTTP/2 и HTTP/3 используют бинарные фреймы.
# HTTP Request
GET /api/users HTTP/1.1
Host: example.com
User-Agent: Mozilla/5.0
Accept: application/json
# HTTP Response
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 45
{"id": 1, "name": "Alice", "email": "[email protected]"}Структура URL
URL идентифицируют ресурсы. Схема выбирает протокол. Хост разрешается через DNS. Порт по умолчанию подразумевается, если не указан. Фрагмент (#) существует только на клиенте и отбрасывается перед отправкой на сервер. Query-строки обычно используются для фильтрации и пагинации.
# Generic URL format
scheme://userinfo@host:port/path?query#fragment
# Example
https://user:[email protected]:8443/api/v1/users?page=2#section
# Components
# scheme - https (protocol)
# userinfo - user:pass (rare, deprecated)
# host - example.com (domain or IP)
# port - 8443 (default: 80 for http, 443 for https)
# path - /api/v1/users (resource location)
# query - page=2 (key=value pairs, & separated)
# fragment - section (client-only, never sent to server)Обзор версий HTTP
HTTP/0.9 был минимальным прототипом. HTTP/1.0 добавил заголовки и типы содержимого, но открывал новое соединение на каждый запрос. HTTP/1.1 ввёл постоянные соединения, обязательный заголовок Host (включив виртуальные хосты) и конвейеризацию. HTTP/2 добавил бинарное мультиплексирование. HTTP/3 работает поверх QUIC, устраняя блокировку начала очереди на транспортном уровне.
# HTTP/0.9 (1991) - single GET, no headers
GET /page.html
# HTTP/1.0 (1996) - headers, status codes, multiple types
GET /page.html HTTP/1.0
# HTTP/1.1 (1997) - persistent connections, Host header, pipelining
GET /page.html HTTP/1.1
Host: example.com
# HTTP/2 (2015) - binary, multiplexing, header compression
# (negotiated via ALPN or h2c upgrade)
# HTTP/3 (2022) - over QUIC (UDP-based)
# (negotiated via Alt-Svc header)Жизненный цикл соединения
HTTP/1.1 по умолчанию держит TCP-соединения открытыми (keep-alive), избегая затрат на повторные рукопожатия. Несколько запросов можно отправить по одному соединению. Заголовок Connection: close сигнализирует о последнем запросе. HTTP/2 мультиплексирует много потоков по одному соединению. Таймаут и максимум Keep-Alive настраиваются на сервере.
# HTTP/1.1 persistent connection (keep-alive)
GET /page1 HTTP/1.1
Host: example.com
Connection: keep-alive
# (server responds, connection stays open)
HTTP/1.1 200 OK
Content-Length: 128
Connection: keep-alive
# Client reuses same TCP connection for next request
GET /page2 HTTP/1.1
Host: example.com
# Closing the connection
GET /final HTTP/1.1
Host: example.com
Connection: closeФормат сообщения
HTTP-сообщения начинаются со стартовой строки (request-line или status-line), затем идут заголовки, пустая строка и необязательное тело. Строки завершаются CRLF. Имена заголовков нечувствительны к регистру. Пустая строка обязательна и сигнализирует начало тела. Тела могут быть любой длины (chunked) или фиксированной (Content-Length).
# Request format
<METHOD> <PATH> <VERSION>
<Header-Name>: <value>
...
<optional body>
# Response format
<VERSION> <STATUS> <REASON>
<Header-Name>: <value>
...
<optional body>
# Lines end with CRLF (
). Headers are case-insensitive.
# A blank line (
) separates headers from body.Отладка через telnet / сырой HTTP
На HTTP можно говорить напрямую по TCP через nc или telnet (порт 80) либо openssl s_client (HTTPS). Это бесценно для отладки. В HTTP/1.1+ обязательно указывайте заголовок Host. Две пустые строки завершают запрос. curl -v показывает обмен в сетевом формате вместе с заголовками.
# Manual HTTP request via netcat/nc
nc example.com 80
GET / HTTP/1.1
Host: example.com
# (press Enter twice to send blank line)
# Using openssl for HTTPS
openssl s_client -connect example.com:443
GET / HTTP/1.1
Host: example.com
# curl with --http1.1 to force version
curl -v --http1.1 https://example.com
curl -v --http2 https://example.com
curl -v --http3 https://example.comHTTP-методы
GET — получение ресурса
GET получает представление ресурса. Он должен быть безопасным (без побочных эффектов) и идемпотентным (повторяемым). GET-запросы кешируются и сохраняются в закладках. Хотя спецификация допускает тело, это не рекомендуется: прокси и CDN могут его отбросить. Для фильтрации используйте query-параметры.
# Basic GET
GET /api/users/42 HTTP/1.1
Host: api.example.com
Accept: application/json
# GET with query parameters
GET /api/users?role=admin&active=true HTTP/1.1
Host: api.example.com
# GET should be safe & idempotent
# - safe: no server state change
# - idempotent: repeating yields same result
# - cacheable: yes
# - body allowed but discouraged (some clients/servers reject)POST — создание ресурса
POST отправляет данные на обработку. Используется для создания новых ресурсов, когда URI назначает сервер (например, /api/users → /api/users/43). POST не безопасен и не идемпотентен: повторная отправка может создать два ресурса. Ответ 201 Created должен содержать заголовок Location со ссылкой на новый ресурс.
# POST creating a new resource
POST /api/users HTTP/1.1
Host: api.example.com
Content-Type: application/json
Content-Length: 52
{"name": "Bob", "email": "[email protected]", "age": 30}
# Response typically 201 Created with Location header
HTTP/1.1 201 Created
Location: /api/users/43
Content-Type: application/json
{"id": 43, "name": "Bob"}
# POST is neither safe nor idempotent.
# Repeating may create duplicate resources.PUT — замена ресурса
PUT заменяет весь ресурс по целевому URI телом запроса. Он идемпотентен: повторение того же PUT даёт то же конечное состояние. PUT наце лен на конкретный URI (например, /users/43), в отличие от POST, направленного на коллекцию. Если поле в PUT опущено, оно обычно удаляется (полная замена).
# PUT replaces the entire resource at the given URI
PUT /api/users/43 HTTP/1.1
Host: api.example.com
Content-Type: application/json
Content-Length: 60
{"id": 43, "name": "Robert", "email": "[email protected]", "age": 31}
# Idempotent: sending the same PUT again yields the same state.
# If the resource doesn't exist, PUT may create it (server-dependent).
# Response
HTTP/1.1 200 OK
# or 204 No Content if no body returnedPATCH — частичное обновление
PATCH применяет частичные изменения к ресурсу, а PUT заменяет его целиком. Простейшая форма — JSON Merge Patch (RFC 7396): отправляйте только изменяемые поля. JSON Patch (RFC 6902) использует массив операций (add, remove, replace, move, copy, test). PATCH по умолчанию НЕ идемпотентен, хотя merge-patch идемпотентен.