Zmieniająca stan
Metoda HTTP PATCH
Żądania PATCH wprowadzają częściowe zmiany w zasobie.
Znaczenie
Klient wysyła dokument zmian, który częściowo modyfikuje zasób docelowy.
Częste zastosowania
Używaj PATCH, gdy zmienić się ma tylko część zasobu, a serwer obsługuje format dokumentu poprawek.
Co sprawdzić
Sprawdź typ nośnika poprawki, obsługę Accept-Patch, błędy walidacji oraz odpowiedzi o konfliktach lub warunkach wstępnych.
Przykładowe żądanie
PATCH /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/merge-patch+json
{"title":"Updated title"}Właściwości
- Bezpieczna
- Nie. Ta metoda może zmienić stan serwera.
- Idempotentna
- Nie. Powtórzenie żądania może wywołać kolejny efekt.
- Buforowalna
- Tylko wtedy, gdy odpowiedź wyraźnie na to pozwala.
- Treść żądania
- Zwykle tak
Źródła
- Rejestr
- IANA HTTP Method Registry
- Specyfikacja
- RFC 5789 Section 2
- Przewodnik
- MDN PATCH