Kuidas valida PUT, POST ja PATCH meetodite vahel REST API disainimisel?

Valik PUT, POST ja PATCH vahel sõltub operatsiooni olemus ressursiga:

• POST — kasutatakse uue ressursi loomisel. Päring saadetakse tavaliselt kogumikule, ja server loob uue elemendi.

• PUT — kasutatakse kogu ressursi uuendamiseks. Klient saadab kogu ressursi esindatuse, ja server asendab olemasoleva objekti selle uue versiooniga.

• PATCH — osalise uuendamise jaoks. Klient saadab ainult muudetud väljad, ja server uuendab neid ilma kogu objekti asendamata.

Näide:

• Kasutaja loomine — POST /users
• Täielik kasutajaprofiili uuendamine — PUT /users/{id}
• Ainult e-posti muutmine — PATCH /users/{id}