¿Cómo elegir entre los métodos PUT, POST y PATCH al diseñar una API REST?

La elección entre PUT, POST y PATCH depende de la naturaleza de la operación con el recurso:

• POST — se usa para crear un nuevo recurso. La solicitud generalmente se envía a la colección, y el servidor crea un nuevo elemento.

• PUT — se aplica para la actualización completa del recurso. El cliente envía una representación completa del recurso, y el servidor reemplaza el objeto existente con esta nueva versión.

• PATCH — para la actualización parcial del recurso. El cliente envía solo los campos modificados, y el servidor los actualiza sin reemplazar todo el objeto.

Ejemplo:

• Crear un usuario — POST /users
• Actualizar todo el perfil del usuario — PUT /users/{id}
• Cambiar solo el email del usuario — PATCH /users/{id}