Django 5 для начинающих

ТЕЛО HTTP

В прошлом шаге мы узнали, что заголовки HTTP содержат большинство важных «метаданных» (данные о данных), которые необходимы для связи с клиентом.

Теперь поговорим о теле HTTP запроса.

Тело – это основная часть сообщения. В зависимости от типа запроса, оно может быть и пустым.

В нашем случае вы можете увидеть тело на вкладке Response. Поскольку мы сделали запрос GET на https://github.com/, тело содержит содержимое HTML-страницы для https://github.com/.

МЕТОДЫ HTTP

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

Примеры запросов:

GET http://www.example.com/users (получить всех пользователей)

POST http://www.example.com/users/a-unique-id (создание нового пользователя)

PUT http://www.example.com/comments/a-unique-id (заменить комментарий)

DELETE http://www.example.com/comments/a-unique-id (удалить комментарий)

PATCH http://www.example.com/users/a-unique-id (изменить данные пользователя)

Когда клиент делает запрос, он указывает тип запроса, используя одну из этих команд. Наиболее важными являются GET, POST, PUT, DELETE и PATCH Есть и другие методы, такие как HEAD и OPTIONS, но они используются редко, поэтому в данном материале мы пропустим их.

GET

GET является наиболее часто используемым методом. Он используется для чтения информации по данному URL-адресу с сервера.

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

Кроме того, запросы GET являются идемпотентными. Это означает, что отправка нескольких запросов GET на один и тот же URL-адрес должна привести к тому же эффекту, что и один запрос GET, поскольку запрос GET просто запрашивает данные с сервера, а не изменяет их.

Запросы GET отвечают кодом состояния 200 (ОК), если ресурс был успешно найден, и 404 (NOT FOUND), если ресурс не был найден. (Отсюда термин «404 page» для сообщений об ошибках при посещении несуществующих или неправильно набранных URL-адресов.)

POST

POST используется для создания нового ресурса, например, через форму регистрации. Функция POST используется при необходимости создания дочернего ресурса (например, нового пользователя) для какого-либо родительского ресурса (http://example.com/users). Родительский ресурс запроса на создание новой сущности определяется по URL-адресу, и сервер обрабатывает новый ресурс и связывает его с родительским ресурсом.

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

Запросы POST отвечают кодом состояния 201 (CREATED) вместе с заголовком местоположения со ссылкой на вновь созданный ресурс.

PUT

PUT используется для замены ресурса, идентифицированного по URL, с использованием информации в теле запроса. PUT также может использоваться для создания нового ресурса. Запросы PUT не считаются безопасными операциями, поскольку они изменяют данные на сервере. Однако он является идемпотентным, поскольку несколько идентичных запросов PUT на замену ресурса должны иметь тот же эффект, что и первый.

Запросы PUT отвечают кодом состояния 200 (OK), если ресурс был успешно заменён, и 404 (NOT FOUND), если ресурс не был найден.

DELETE

DELETE используется для удаления ресурса, определенного по URL-адресу. Запросы DELETE являются идемпотентным, поскольку если УДАЛИТЬ ресурс, он будет удален, и даже если вы сделаете несколько идентичных запросов DELETE, результат будет одинаковым: удаленный ресурс.

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

Запросы DELETE отвечают кодом состояния 200 (OK) в случае успешного удаления или 404 (NOT FOUND), если не удалось найти удаляемый ресурс.

PATCH

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

Запросы PATCH отвечают кодом состояния 2ХХ(например: 200(OK), если ответ содержит тело сообщения или 204(NO CONTENT), если в ответе нет тела сообщения), если ресурс был успешно изменён, и 404 (NOT FOUND), если ресурс не был найден.

Все вышеуказанные запросы возвращают значение 500 (ВНУТРЕННЯЯ ОШИБКА СЕРВЕРА), если обработка завершается не успешно и сервер выдаёт ошибку.

ЗАКЛЮЧЕНИЕ

HTTP далеко не прост. Но, как вы видите, это критически важный компонент отношений между клиентом и сервером.