Idempotentna
Metoda HTTP PUT
Żądania PUT zastępują zasób docelowy zawartością żądania.
Znaczenie
Klient prosi serwer o zapisanie załączonej reprezentacji pod docelowym URI.
Częste zastosowania
Używaj PUT, gdy klient zastępuje znany zasób lub zapisuje pod znanym adresem URL.
Co sprawdzić
Sprawdź, czy żądanie zawiera pełną reprezentację zastępczą i czy nagłówki warunków wstępnych zapobiegają przypadkowemu nadpisaniu, gdy to potrzebne.
Przykładowe żądanie
PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"Updated article"}Właściwości
- Bezpieczna
- Nie. Ta metoda może zmienić stan serwera.
- Idempotentna
- Tak. Powtórzenie tego samego żądania powinno mieć ten sam zamierzony efekt.
- Buforowalna
- Nie
- Treść żądania
- Zwykle tak
Źródła
- Rejestr
- IANA HTTP Method Registry
- Specyfikacja
- RFC 9110 Section 9.3.4
- Przewodnik
- MDN PUT