Jak wybrać między metodami PUT, POST i PATCH podczas projektowania API REST?

Wybór między PUT, POST i PATCH zależy od charakteru operacji na zasobie:

• POST — służy do tworzenia nowego zasobu. Żądanie jest zwykle wysyłane do kolekcji, a serwer tworzy nowy element.

• PUT — służy do pełnej aktualizacji zasobu. Klient wysyła pełną reprezentację zasobu, a serwer zastępuje istniejący obiekt tą nową wersją.

• PATCH — do częściowej aktualizacji zasobu. Klient wysyła tylko zmienione pola, a serwer je aktualizuje bez zamiany całego obiektu.

Przykład:

• Utwórz użytkownika — POST /users
• Zaktualizuj cały profil użytkownika — PUT /users/{id}
• Zmień tylko email użytkownika — PATCH /users/{id}