PUT

Метод PUT создает новый ресурс или заменяет представление целевого ресурса данными запроса.

Разница между PUT и POST заключается в том, что PUT является идемпотентным: вызов его один раз или несколько раз подряд имеет одинаковый эффект (то есть нет побочных эффектов), в то время как последовательные одинаковые запросы POST могут иметь дополнительные эффекты, подобные размещению заказа несколько раз.

Запрос имеет тело	Да
Успешный ответ имеет тело	Возможно
Безопасный	Нет
Идемпотентный	Да
Кэшируемый	Нет
Допускается в формах HTML	Нет

Синтаксис

PUT /new.html HTTP/1.1

Пример

Запрос

PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16

<p>New File</p>

Ответы

Если целевой ресурс не имеет текущего представления и запрос PUT успешно создает его, то сервер-источник должен сообщить об этом агенту пользователя, отправив ответ 201 (Created) .

HTTP/1.1 201 Created
Content-Location: /new.html

Если целевой ресурс имеет текущее представление и это представление успешно модифицировано в соответствии с состоянием вложенного представления, то сервер-источник должен отправить либо ответ 200 (OK) , либо ответ 204 (No Content) , чтобы указать на успешное выполнение запроса.

HTTP/1.1 204 No Content
Content-Location: /existing.html

Спецификации

Спецификация
Семантика HTTP # PUT

Совместимость с браузерами

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet
`PUT`	Да	12	Да	Да	Да	Да	Да	Да	Да	Да	Да	Да

См. также

201
204

© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/PUT