PUT

La petición HTTP PUT crea un nuevo elemento o reemplaza una representación del elemento de destino con los datos de la petición.

La diferencia entre el método PUT y el método POST es que PUT es un método idempotente: llamarlo una o más veces de forma sucesiva tiene el mismo efecto (sin efectos secundarios), mientras que una sucesión de peticiones POST idénticas pueden tener efectos adicionales, como envíar una orden varias veces.

Petición con cuerpo
Respuesta (correcta) con cuerpo No
Seguro No
Idempotente Yes
Cacheable No
Permitido en HTML forms (en-US) No

Sintaxis

PUT /nuevo.html HTTP/1.1

Ejemplos

Petición

PUT /nuevo.html HTTP/1.1
Host: ejemplo.com
Content-type: text/html
Content-length: 16

<p>Nuevo Archivo</p>

Respuestas

Si el elemento de destino no existe y la petición PUT lo crea de forma satisfactoria, entonces el servidor debe informar al usuario enviando una respuesta 201 (Created) .

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

Si el elemento existe actualmente y es modificado de forma satisfactoria, entonces el servidor de origen debe enviar una respuesta 200 (OK) o una respuesta 204 (en-US) (No Content) para indicar que la modificación del elemento se ha realizado sin problemas.

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

Especificaciones

Specification
HTTP Semantics
# PUT

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también