Ako si vybrať medzi metódami PUT, POST a PATCH pri navrhovaní REST API?

Voľba medzi PUT, POST a PATCH závisí od povahy operácie s prostriedkom:

• POST — sa používa na vytvorenie nového prostriedku. Žiadosť sa zvyčajne odosiela na kolekciu a server vytvorí nový prvok.

• PUT — sa používa na úplnú aktualizáciu prostriedku. Klient odošle úplnú reprezentáciu prostriedku a server nahradí existujúci objekt touto novou verziou.

• PATCH — na čiastočnú aktualizáciu prostriedku. Klient odošle iba zmenené polia a server ich aktualizuje bez nahradenia celého objektu.

Príklad:

• Vytvoriť používateľa — POST /users
• Aktualizovať celý profil používateľa — PUT /users/{id}
• Zmeniť iba email používateľa — PATCH /users/{id}