Estoy desarrollando una API RESful con java en Spring y me surgió una duda.
Tengo expuestas unas APIs para el recurso usuario (/users), el id de usuario lo obtengo por el token jwt por lo que en las URI que expongo en ese ejemplo me salto el id para el recurso (en vez de /users/1/displayName utilizo /users/displayName). Tengo clara la nomenclatura a utilizar para acceder a los recursos, por ejemplo, GET a la raiz para obtener el usuario, /users/displayname si quisiera obtener el nombre de usuario etc.
El tema es, para realizar una actualización parcial del recurso usuario debería usar el método PATCH e igual he visto que se hace mediante JSON indicando la acción, la ruta al recurso y el valor según corresponda pero mi problema es que en este recurso concreto no quiero que se actualicen más de dos campos (profileImage y displyName) por lo que el uso del JSON "genérico" lo veo demasiado tedioso.
Se me ocurrió entonces exponer dos métodos PATCH, users/displayName y users/profileImage pero claro, ahora la URI indica que no se está accediendo al recurso user sino al recurso dislpayName de user, entonces, ¿no debería convertirse en un método PUT al tratarse de una actualización completa del recurso al que se hace referencia en la URI?
displayName
oprofileImage
indican la propiedad ha actualizar, son el argumento, perfectamente tu URL podría tener esta forma /users/1?campo=displayName y sería lo mismo, pero aquí no estarías dudando. Piénsalo de este modo, en tu base de datos vas a actualizar la tabla user, por lo que el verbo debería ir relacionado a aquella entidad (en mi humilde opinión)