Idempotente
Método HTTP PUT
Requisições PUT substituem o recurso de destino pelo conteúdo da requisição.
Significado
O cliente pede que o servidor armazene a representação incluída na URI de destino.
Usos comuns
Use PUT quando o cliente estiver substituindo um recurso conhecido ou gravando em uma URL conhecida.
O que verificar
Verifique se a requisição contém a representação de substituição completa e se os cabeçalhos de pré-condição evitam sobrescritas acidentais quando necessário.
Exemplo de requisição
PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"Updated article"}Propriedades
- Seguro
- Não. Este método pode alterar o estado do servidor.
- Idempotente
- Sim. Repetir a mesma requisição deve ter o mesmo efeito pretendido.
- Cacheável
- Não
- Corpo da requisição
- Geralmente sim
Referências
- Registro
- IANA HTTP Method Registry
- Especificação
- RFC 9110 Section 9.3.4
- Guia
- MDN PUT