PUT, DELETE и другие HTTP-методы

Метод PUT в HTTP протоколе используется для отправки данных на сервер с целью замены или обновления существующих данных. В отличие от метода POST, который обычно применяется для создания новых ресурсов, PUT работает с уже существующими, полностью заменяя их содержимое.

Основная цель PUT — обновление или замена ресурса по указанному URL. Метод PUT требует, чтобы в теле запроса передавались все данные, которые должны быть обновлены, даже если изменяется только небольшая часть ресурса. Если ресурс по данному адресу не существует, то может быть создан новый ресурс, в зависимости от настроек сервера.

Пример использования PUT:

const axios = require('axios');

axios.put('https://api.example.com/user/123', {
  name: 'New Name',
  age: 30
})
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

В этом примере PUT-запрос отправляет обновленные данные о пользователе с ID 123. Сервер должен обработать эти данные и заменить текущую информацию.

Особенности PUT:

  • PUT является идемпотентным методом, что означает, что многократное выполнение одного и того же запроса не изменит результат.
  • Сервер может создать новый ресурс, если его нет, но эта практика не является стандартной и может быть ограничена конфигурацией сервера.
  • Метод PUT всегда должен отправлять полные данные ресурса, даже если изменяется только его часть.

DELETE метод

Метод DELETE используется для удаления ресурса с сервера. Он отправляется на URL, который указывает на определённый ресурс, и сервер должен удалить его, если он существует. Этот метод также является идемпотентным, то есть если выполнить несколько запросов DELETE на один и тот же ресурс, результат не изменится после первого запроса — ресурс останется удалённым.

Пример использования DELETE:

const axios = require('axios');

axios.delete('https://api.example.com/user/123')
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

В этом примере DELETE-запрос удаляет пользователя с ID 123. После успешного выполнения запроса сервер должен вернуть подтверждение об удалении или соответствующий статус.

Особенности DELETE:

  • DELETE является идемпотентным методом, что означает, что повторное выполнение запроса на удаление не вызовет ошибок, если ресурс уже удалён.
  • Сервер может вернуть разные статусы в зависимости от ситуации: 200 OK в случае успешного удаления или 404 Not Found, если ресурс не найден.
  • Обычно при удалении ресурса возвращается ответ с информацией о статусе операции, но содержание ответа не обязательно.

PATCH метод

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

Пример использования PATCH:

const axios = require('axios');

axios.patch('https://api.example.com/user/123', {
  age: 31
})
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

В данном примере PATCH-запрос обновляет только возраст пользователя с ID 123, оставляя остальные данные без изменений.

Особенности PATCH:

  • PATCH не заменяет весь ресурс, а только те его части, которые указаны в запросе.
  • PATCH может быть полезен, если нужно обновить только одно или несколько полей ресурса, что сокращает объём данных, отправляемых на сервер.
  • Метод не является идемпотентным, хотя в большинстве случаев его использование предполагает идемпотентность. Однако поведение сервера зависит от его реализации.

OPTIONS метод

Метод OPTIONS используется для получения информации о доступных методах и опциях, которые сервер поддерживает для определённого ресурса. Этот метод позволяет клиенту узнать, какие операции разрешены для определённого URL, и какие заголовки могут быть использованы. Ответ на запрос OPTIONS содержит информацию о поддерживаемых методах в виде заголовков Allow.

Пример использования OPTIONS:

const axios = require('axios');

axios.options('https://api.example.com/user')
  .then(response => console.log(response.headers['allow']))
  .catch(error => console.error(error));

Здесь OPTIONS-запрос позволяет узнать, какие методы разрешены для работы с ресурсом https://api.example.com/user.

Особенности OPTIONS:

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

HEAD метод

Метод HEAD схож с методом GET, за исключением того, что сервер не должен возвращать тело ответа. Используется для получения только заголовков ответа без данных, что может быть полезно для проверки метаданных, таких как размер ресурса или дата последнего изменения.

Пример использования HEAD:

const axios = require('axios');

axios.head('https://api.example.com/user/123')
  .then(response => console.log(response.headers))
  .catch(error => console.error(error));

Этот запрос позволяет получить только заголовки для ресурса пользователя с ID 123 без передачи его содержимого.

Особенности HEAD:

  • HEAD возвращает те же заголовки, что и GET, но без тела.
  • Может быть полезен для проверки состояния ресурса или для получения метаинформации о содержимом.
  • Этот метод также является идемпотентным, то есть многократные запросы HEAD не изменяют результат.

Conclusion

Методы PUT, DELETE, PATCH, OPTIONS и HEAD обеспечивают разнообразные способы взаимодействия с веб-ресурсами, позволяя не только обновлять и удалять данные, но и запрашивать информацию о доступных методах и получать метаданные. Важно понимать, когда и как использовать каждый из этих методов, чтобы оптимизировать работу с сервером и обеспечить правильную обработку запросов в приложении.

Оглавление