Las modas tecnológicas van y vienen, pero los principios de diseño de APIs REST siguen siendo relevantes después de más de dos décadas. Una API intuitiva y consistente distingue a los mejores desarrolladores.
Recursos, No Acciones
Usa sustantivos para las rutas y verbos HTTP para las acciones. /users/123 es un recurso; /getUser/123 es un procedimiento. Esta distinción mejora la predecibilidad de tu API de forma exponencial.