ru

HTTP PUT — метод запроса, который создаёт или полностью заменяет ресурс по известному URL. Клиент отправляет на этот адрес новое представление ресурса, а сервер сохраняет его целиком по указанному пути.

Идемпотентность PUT

Главное свойство PUT — идемпотентность: повторение одного и того же запроса приводит к тому же результату. Отправив PUT дважды, вы не создадите две копии — ресурс просто перезапишется теми же данными. Этим PUT отличается от POST, который обычно каждый раз создаёт новый объект. Как и все методы HTTP, PUT указывается в начале запроса вместе с путём и заголовками.

PUT, POST и GET

Чтобы выбрать метод, полезно сравнить их поведение:

  • PUT — полностью заменяет ресурс по известному адресу и идемпотентен.
  • POST — создаёт новый ресурс, адрес назначает сервер; не идемпотентен.
  • GET — только читает данные и не меняет состояние сервера.

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

HTTP PUT: создание или полная замена ресурса по URL
Узнать больше

Облако тегов