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 | Sí |
---|---|
Respuesta (correcta) con cuerpo | No |
Seguro | No |
Idempotente | Yes |
Cacheable | No |
Permitido en HTML forms | 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
(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