Бесплатная миграция IT-инфраструктуры в облако

HTTP-запросы: параметры, методы и коды состояния

Команда Timeweb Cloud
Команда Timeweb Cloud
Наши инженеры, технические писатели, редакторы и маркетологи
13 февраля 2024 г.
5215
14 минут чтения
Средний рейтинг статьи: 5

Когда пользователь вводит URL-адрес сайта в поисковой строке браузера, его компьютер или другое устройство инициирует соединение с сервером и отправляет ему HTTP-запрос — сообщение с некой информацией. Это может быть просьба отправить ему HTML-страницу или, наоборот, данные пользователя, которые серверу нужно обработать. По сути, браузер предоставляет пользователю графический интерфейс для получения информации с сайтов с помощью HTTP. 

HTTP-сообщения — это основной способ коммуникации устройств в клиент-серверной архитектуре. Кроме него есть и другие методы, например FTP или P2P. Но в бытовой деятельности интернет-пользователей наиболее частым сценарием является именно HTTP.

В этой статье мы рассмотрим, как общаются серверы и устройства пользователей: что такое HTTP-сообщение, какая у него структура и из чего состоит HTTP-запрос и ответ. А также вскользь затронем сам протокол HTTP и его основы.

Для чего нужен HTTP

Чтобы устройства в компьютерной сети понимали друг друга, существуют специальные правила, которые регламентируют формат общения. Такие правила называются протоколами, и один из них — это HTTP.

Он необходим для гипертекстовой передачи данных, например, HTML-страниц. Сам протокол относится к седьмому уровню модели OSI, т.е. прикладному. 

По сути, HTTP-сообщения — это простой текст. Сам протокол регламентирует правила составления этого текста и общения между устройствами: что идёт в начале, какая структура HTTP-запроса и ответа, за сколько сервер должен ответить и другое.

Обычно для приёма сообщений по HTTP используется 80 порт, а для зашифрованной версии HTTPS — 443.

Основная версия протокола, которая используется сейчас, — это HTTP 1.1. По сравнению с первой версией в нём уже есть заголовки — параметры, которые описывают HTTP-запросы, поддержаны новые методы и многое другое.

Из чего состоит HTTP-сообщение

HTTP-сообщение — это простой текст, составленный по определенным правилам. В схеме HTTP-запросов и ответов есть три основных компонентов:

  • стартовая строка HTTP-запроса и ответа,

  • заголовки и их значения,

  • опционально — тело сообщения.

Стартовая строка

Это начало HTTP-сообщения. Она занимает одну строку, и в HTTP-протоколе стартовые строки запросов и ответов немного различается. 

В основе HTTP-запроса указывается:

  • Метод, который характеризуют желаемый результат запроса: передача данных, загрузка HTML-страницы или что-то другое.
  • URI. Это уникальный идентификатор ресурса. 
  • Версия протокола.

Вот пример стартовой строки HTTP-запроса:

GET /blog/examplepage HTTP/1.1

Что он означает: клиент с помощью метода GET запрашивает у сервера HTML-страницу, размещенную в /blog/examplepage, через протокол версии 1.1. 

В стартовой строке HTTP-ответа указаны другие параметры:

  • Версия протокола.
  • Код состояния (числа, которые характеризуют статусы HTTP-запроса).
  • (Опционально) Текстовое пояснение к коду.

Например, если запрос был успешно обработан, сервер начнёт HTTP-сообщение таким образом:

HTTP/1.1 200 OK

Методы HTTP-запросов

Методы описывают тип запроса: запрашивает ли клиент только страницу, передаёт ли информацию внутри тела запроса и другое. В основном для получения и размещения данных используются два самых популярных метода — POST и GET

Краткое описание всех методов:

  • GET. С помощью него клиент запрашивает у сервера содержимое ресурса. Например, HTML-страницу. Кроме того, с помощью этого метода на сервер можно передать данные клиента. Для этого в адресе ресурса после символа ? необходимо добавить параметры и их значения, которые нужно передать на сервер. Данные, передаваемые в HTTP-запросе, выглядят следующим образом:

GET /blog/examplepage?variable1=somevalue1&variable2=somevalue2 HTTP/1.1

Здесь variable1 и variable2 — это параметры, которые передаст клиент, а somevalue1 и somevalue2 — их значения. Важное свойство метода — идемпотентность: если выполнить HTTP-запрос несколько раз с одинаковым содержанием, то результат тоже будет одинаковым. 

  • HEAD. Это метод для получения заголовков ресурса. Часто его применяют для получения метаданных и проверки того, менялся ли ресурс с момента последнего посещения и существует ли он. 

  • POST. С помощью этого метода клиент может передать данные в теле сообщения, например, в случаях, когда данные нельзя передать с помощью метода GET. Это может быть пост в соцсети или данные банковской карты, которую нежелательно оставить в истории поиска. Также POST является неидемпотентным методом: при его отправке результат может отличаться. Ещё одна особенность POST — ответы на него не будут кэшироваться.

  • OPTIONS. С помощью него можно запросить список методов, которые он или его ресурс поддерживает. Также OPTIONS можно использовать для того, чтобы «пропинговать» сервер — протестировать его работоспособность.

  • PUT. Этот метод создаёт новый ресурс или заменяет существующий данными, которые указаны в теле запроса.

  • PATCH. Работает таким же образом, как и PUT, только по отношению к части ресурса.

  • DELETE. Клиент сообщает о том, что хотел бы удалить некий ресурс.

  • TRACE. С помощью него можно проверить, изменяют ли промежуточные узлы в сети запрос клиента.

  • CONNECT. Запускает туннель между клиентом и сервером.

Коды состояния

Это трёхзначное число в ответе, которое характеризуют статус его обработки. Первая цифра обозначает код класса. Всего их пять. Расскажем немного подробнее о каждом и распространённых кодах.

Informational. С помощью этих кодов состояния описывается сам процесс передачи информации. Как пример, сервер успешно принял запрос, но пока что ещё обрабатывает его.  Вот несколько распространённых кодов этого класса:

  • 100. Такой код характеризует то, что HTTP-сообщение клиента успешно принято и он может дальше отправлять их.

  • 101. В HTTP-запросе можно попросить сервер переключиться на другую версию протокола, используя заголовок Upgrade. Если сервер удовлетворит такой запрос, то в ответе пришлёт код 101. 

  • 102. Используется в работе HTTP-запросов, которые сервер принял, но ещё не успел обработать.

Success. Этот класс кодов используется для того, чтобы проинформировать клиента об успешности его запроса. Чаще всего пользователи сталкиваются с этими кодами:

  • 200 OK. Самый распространённый код состояния. Он подразумевает, что запрос клиента выполнен успешно.

  • 201. Такой код используется в тех случаях, если с помощью запроса создаётся новый ресурс. Например, с помощью метода PUT. Если операция выполнена успешно, в ответе будет указан такой код.

Redirection. Такой класс кодов состояния используется в тех случаях, когда для выполнения операции нужно изменить запрос. Чаще всего это связано с неправильным URI ресурса.

Несколько примеров:

  • 301 Moved Permanently. Используется в тех случаях, когда запрашиваемый ресурс переместили в другую директорию навсегда — её можно будет найти в заголовке Location. Также у этого кода состояния есть похожий код 308, который также означает, что клиент должен использовать такой же метод к новому местоположению ресурса. 

  • 302 Found. Этот код состояния применяется тогда, когда запрашиваемый ресурс в текущий момент временно размещён на другом адресе. Его укажут в заголовке Location. Ещё у этого кода состояния есть похожий код 307, который используется в тех случаях, когда клиент должен использовать такой же метод.

Client Error. Коды состояния, которые относятся к этому классу, используются в случаях, когда во время выполнения запроса произошла ошибка на стороне клиента.

Часто встречаются такие коды:

  • 400 Bad Request. Клиент составил своё HTTP-сообщение неправильно.

  • 403 Access Forbidden. К ресурсу необходим другие права доступа.

  • 404 Not Found. Такой код состояния встречается чаще всего и означает, что сервер принял запрос, но по указанному адресу ничего не обнаружил.

Server Error. Это похожий класс кодов состояния, которые сигнализируют об ошибке. Однако в этот раз ошибка произошла на стороне сервера. Вот несколько вариантов:

  • 500 Internal Server Error. Сервер не смог обработать запрос из-за внутренней ошибки. Например, в PHP-коде, который используется для обработки запроса, есть проблемы.

  • 502 Bad Gateway и 504 Gateway Time Out. Иногда сервер выступает в роли промежуточного узла. Если следующий узел вернёт ошибку, сервер в ответе укажет код состояния 502. Если не ответит за отведённое время, то 504.

  • 503 Service Unavailable. Такой код состояния означает, что сейчас на сервере технические неполадки и он не может обработать запрос.

В конце статьи мы добавили таблицу со всеми HTTP-кодами, статусами и их описанием.

vds

Что такое заголовки в HTTP?

Они определяют дополнительные параметры HTTP-сообщения. Они представляют собой пару из параметра и его значения, которые разделяются двоеточием. На одну строку — один параметр. 

Все заголовки можно разделить на четыре типа:

  • Те, что используются и в HTTP-запросах, и в HTTP-ответах, а также не относятся к телу сообщения.

  • Параметры HTTP-запроса.

  • Заголовки только HTTP-ответов.

  • И такие, что содержат данные о теле сообщения: его длину, формат данных и многое другое.

В целом, заголовков достаточно много, поэтому расскажем о самых распространённых: 

  • Host. Это заголовок HTTP-запроса, который содержит в себе адрес сервера, к которому делает запрос клиент. Если соединить значение Host с URI, получится URL-адрес ресурса. Пример HTTP-запроса:

GET /blog/examplepage HTTP/1.1
Host: timeweb.cloud
  • Date. Это заголовок с датой, когда было создано HTTP-сообщение.

  • Last-Modified. Если ресурс изменялся, то благодаря Last-Modified сервер сообщит, когда именно.

  • Content-Type. Характеризует то, в каком формате и кодировке передаётся тело сообщения.

  • Content-Language. С помощью этого заголовка можно указать язык тела сообщения. 

  • Content-Length. Используется для того, чтобы сообщить размер тела сообщения. Полезен в тех случаях, когда тело сообщения слишком громоздко.

Тело сообщения

Это необязательный элемент HTTP-сообщения с полезной нагрузкой. Необязательный потому, что не каждое сообщение содержит в себе HTML-страницу или пользовательские данные. Например, в теле сообщения указывается содержимое HTTP-запроса при использовании метода POST

От остальных элементов HTTP-запроса и ответа эта отделяется одной пустой строкой. Его конец — это две пустые строки. Если внутри тела есть две пустые строки, то нужно использовать заголовок Content-Length. С ним вторая сторона будет ожидать полного сообщения, длина которого равна значения заголовка.

Чтобы все стороны диалога по HTTP-протоколу понимали, как именно передаётся информация, используется стандарт MIME для идентификация содержимого по заголовку Content-Type. Например, он регламентирует обычный текст, HTML-страницы или JSON. 

Ещё стандарт описывает нестандартные ситуации. Например, в данных форме. Они передаются в формате «ключ=значение», поэтому знак равно в данных заменяется на код %3D

Список HTTP-кодов

Код

Статус

Описание

100

Continue

Промежуточный ответ, указывающий, что начальная часть запроса принята и клиент может продолжать отправку.

101

Switching Protocols

Сервер сменил версию протокола по просьбе клиента.

102

Processing

Так сервер сообщает клиенту, что принял запрос, но всё ещё обрабатывает его. Необходим для того, чтобы соединение не прекратилось из-за превышения времени ожидания. Этот код состояния используется в WebDAV — наборе расширений и дополнений к HTTP. 

103

Early Hints

Код используется для возврата части заголовков, когда полный список не может быть быстро сформирован.

200

OK

Запрос успешно обработан.

201

Created

Запрос успешно выполнен, и в результате обработки появился новый ресурс.

202

Accepted

Сервер принял запрос, но пока что ещё не обработал его.

203

Non-Authoritative Information

Сервер взял информацию для ответа не из первоисточника. Например, резервной копии.

204

No Content

В ответе нет тела сообщения.

205

Reset Content

Сервер сообщает клиенту, что тот должен сбросить введённые данные.

206

Partial Content

Используется, если клиент запросил только фрагмент ресурса.

207

Multi-Status

Сервер передаёт в ответе результаты выполнения сразу нескольких операций. Используется в WebDAV.

208

Already Reported

Используется в WebDAV и означает, что часть сообщения есть в предыдущем ответе.

226

IM Used

Сервер успешно обработал заголовок запроса A-IM. Используется для дельта-кодирования.

300

Multiple Choices

Сервер может предоставить ресурс в разных форматах MIME.

301

Moved Permanently

Запрашиваемый ресурс переместили в другую директорию навсегда — её можно будет найти в заголовке Location.

302

Found

Запрашиваемый ресурс в текущий момент временно размещён на другом адресе — его можно будет найти в заголовке Location.

303

See Other

Ответ на запрос можно найти по другому URI с помощью GET.

304

Not Modified

Используется, если клиент запрашивал ресурс с заголовками If-Modified-Since или If-None-Match.

305

Use Proxy

Запрашиваемый ресурс доступен только через прокси.

307

Temporary Redirect

Запрашиваемый ресурс временно перемещен на другой URI. Для обращения к нему клиент должен использовать тот же метод, что и в первоначальном запросе.

308

Permanent Redirect

Запрашиваемый ресурс был навсегда перемещен на другой URI. Для обращения к нему клиент должен использовать тот же метод, что и в первоначальном запросе.

400

Bad Request

Клиент составил своё HTTP-сообщение неправильно.

401

Unauthorized

Чтобы получить доступ к ресурсу, клиент должен пройти аутентификацию.

402

Payment Required

Предусмотрен для будущего использования.

403

Forbidden

У клиента нет необходимых прав доступа

404

Not Found

К сожалению, на данном адресе сервер ничего не нашёл. Скорее всего, клиент ошибся с URI или страница была удалена.

405

Method Not Allowed

Сервер не поддерживает тот метод запроса, что выбрал клиент.

406

Not Acceptable

Сервер вернёт такой код, если он или запрашиваемый ресурс не поддерживает заголовки запроса.

407

Proxy Authentication Required

Клиент должен пройти аутентификацию на прокси-сервере.

408

Request Timeout

Клиент не передал информацию серверу в определенный срок. 

409

Conflict

Запрос не может быть выполнен из-за конфликта с другими запросами. Например, когда несколько пользователей пытаются обновить или изменить ресурс.

410

Gone

Означает, что ресурс удалён или недоступен.

411

Length Required

Клиент должен указать размер тела сообщения.

412

Precondition Failed

Сервер вернёт такой код состояния, если ни один из условных заголовков запроса не выполняется.

413

Payload Too Large

Тело запроса слишком велико.

414

URI Too Long

URI слишком длинный. Такая ситуация может возникнуть, когда клиент пытается передать большое количество параметров через метод GET.

415

Unsupported Media Type

Сервер не работает с указанным типом данных.

416

Range Not Satisfiable

Range вышел за пределы ресурса.

417

Expectation Failed

Сервер не смог удовлетворить условия, описанные в заголовке запроса Expect.

418

I'm a teapot

Шутливый код, введенный в протоколе HTCPCP.

421

Misdirected Request

Запрос был перенаправлен на другой сервер, который не смог его осуществить.

422

Unprocessable Entity

В запросе есть логическая ошибка. Используется в WebDAV.

423

Locked

Ресурс, к которому делается запрос, был заблокирован из-за используемого метода. Используется в WebDAV.

424

Failed Dependency

Запрос не выполнен, так как он зависел от другого запроса, который также не был обработан. Используется в WebDAV.

425

Too Early

Сервер не готов обрабатывать запрос. 

426

Upgrade Required

Клиент должен обновить версию протокола для выполнения запроса.

428

Precondition Required

Клиент должен использовать заголовки с условиями. 

429

Too Many Requests

Клиент отправил слишком много запросов за короткий промежуток времени.

431

Request Header Fields Too Large

Сервер отказывается обрабатывать запрос, потому что поле с заголовками слишком большое.

451

Unavailable For Legal Reasons

Этот код означает, что ресурс недоступен на юридическим причинам. Например, его заблокировали по требования государственных органов.

500

Internal Server Error

Внутренняя ошибка сервера.

501

Not Implemented

Сервер не может выполнить запрос, потому что не поддерживает необходимые для этого возможности.

502

Bad Gateway

Если сервер — прокси или промежуточный шлюз, он отправит такой код в том случае, когда следующий узел возвращает ошибку.

503

Service Unavailable

Сейчас сервер не может обработать запрос по техническим причинам. 

504

Gateway Timeout

Если сервер — прокси или промежуточный шлюз, он отправит такой код в том случае, когда следующий узел не ответил за отведённое время.

505

HTTP Version Not Supported

Сервер не поддерживает выбранную версию протокола.

506

Variant Also Negotiates

Внутренняя конфигурация сервера привела к цикличности.

507

Insufficient Storage

Серверу не хватает места для выполнения запроса. Используется в WebDAV.

508

Loop Detected

При обработке запроса возник бесконечный цикл.

510

Not Extended

На сервере нет расширения, которое хочет использовать клиент.

511

Network Authentication Required

Код, который использует провайдер сети для того, чтобы сообщить о необходимости авторизоваться в ней.

Выгодные цены на VDS/VPS в Timeweb Cloud

Заключение

В рамках этой статьи мы рассмотрели основные составляющие HTTP-сообщений: стартовую строку, заголовки и тело сообщения. Также не обошли вниманием и их особенности, такие как методы запросов и коды ошибки. И немного обсудили, что такое HTTP-протокол в целом.

Почитать подробнее об об актуальной спецификации HTTP/1.1 можно в RFC9112.

13 февраля 2024 г.
5215
14 минут чтения
Средний рейтинг статьи: 5
Пока нет комментариев