Jak vybrat mezi metodami PUT, POST a PATCH při navrhování REST API?

Volba mezi PUT, POST a PATCH závisí na povaze operace s prostředkem:

• POST — používá se k vytvoření nového prostředku. Žádost se obvykle odesílá na kolekci a server vytvoří nový prvek.

• PUT — používá se k úplné aktualizaci prostředku. Klient odešle úplnou reprezentaci prostředku a server nahradí existující objekt touto novou verzí.

• PATCH — pro částečnou aktualizaci prostředku. Klient odešle pouze změněná pole a server je aktualizuje bez nahrazení celého objektu.

Příklad:

• Vytvořit uživatele — POST /users
• Aktualizovat celý profil uživatele — PUT /users/{id}
• Změnit pouze email uživatele — PATCH /users/{id}