Junior — Middle
Wyjaśnij, co oznacza metoda PUT w REST API i w jakich przypadkach jest używana.
sobes.tech AI
Odpowiedź od AI
Metoda PUT w API REST służy do pełnej aktualizacji zasobu lub jego utworzenia, jeśli jeszcze nie istnieje. W przeciwieństwie do PATCH, który stosuje częściowe zmiany, PUT zastępuje cały zasób przesłanymi danymi.
Główne cechy PUT:
- Idempotentność: wielokrotne wywołanie z tymi samymi danymi nie zmieni wyniku.
- Zazwyczaj używany do aktualizacji istniejącego obiektu za pomocą znanego URI.
- Jeśli zasób nie istnieje, serwer może go utworzyć z podanym URI.
Przykład: jeśli masz użytkownika o ID 123, żądanie PUT na /users/123 z pełnym opisem użytkownika zastąpi wszystkie pola tego użytkownika nowymi wartościami.
Używa się PUT, gdy trzeba zagwarantować pełną zamianę zasobu, a nie jego częściową aktualizację.