Kaip pasirinkti tarp PUT, POST ir PATCH metodų kuriant REST API?

Pasirinkimas tarp PUT, POST ir PATCH priklauso nuo išteklių operacijos pobūdžio:

• POST — naudojamas naujam ištekliui sukurti. Užklausa dažniausiai siunčiama į kolekciją, ir serveris sukuria naują elementą.

• PUT — taikomas viso išteklio atnaujinimui. Klientas siunčia visą išteklio reprezentaciją, ir serveris pakeičia esamą objektą nauja versija.

• PATCH — daliniam išteklių atnaujinimui. Klientas siunčia tik pakeistus laukus, ir serveris juos atnaujina nesikeičiant viso objekto.

Pavyzdys:

• Vartotojo sukūrimas — POST /users
• Visas vartotojo profilio atnaujinimas — PUT /users/{id}
• Tik vartotojo el. pašto keitimas — PATCH /users/{id}