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 |