Sobes.tech
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ę.