Explică ce înseamnă metoda PUT în REST API și în ce cazuri se utilizează.

Metoda PUT în API-ul REST este utilizată pentru actualizarea completă a unei resurse sau pentru crearea acesteia dacă nu există încă. Spre deosebire de PATCH, care aplică modificări parțiale, PUT înlocuiește întreaga resursă cu datele trimise.

Caracteristici principale ale PUT:

• Idempotent: apelurile repetate cu aceleași date nu vor schimba rezultatul.
• De obicei, este folosit pentru a actualiza un obiect existent printr-un URI cunoscut.
• Dacă resursa nu există, serverul o poate crea cu URI-ul specificat.

Exemplu: dacă aveți un utilizator cu ID 123, o solicitare PUT la /users/123 cu o descriere completă a utilizatorului va înlocui toate câmpurile acestuia cu valori noi.

Se folosește PUT atunci când trebuie garantată înlocuirea completă a resursei, nu actualizarea parțială.