Idempotente
Metodo HTTP PUT
Le richieste PUT sostituiscono la risorsa di destinazione con il contenuto della richiesta.
Significato
Il client chiede al server di memorizzare la rappresentazione allegata all'URI di destinazione.
Usi comuni
Usa PUT quando il client sostituisce una risorsa nota o scrive su un URL noto.
Cosa controllare
Controlla che la richiesta contenga la rappresentazione di sostituzione completa e che gli header di precondizione impediscano sovrascritture accidentali quando necessario.
Esempio di richiesta
PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"Updated article"}Proprietà
- Sicuro
- No. Questo metodo può modificare lo stato del server.
- Idempotente
- Sì. Ripetere la stessa richiesta dovrebbe avere lo stesso effetto previsto.
- Memorizzabile in cache
- No
- Corpo della richiesta
- Di solito sì
Riferimenti
- Registro
- IANA HTTP Method Registry
- Specifica
- RFC 9110 Section 9.3.4
- Guida
- MDN PUT