Lo que usted llama único API REST puede denominarse conjunto particular de recursos o recursos de la API REST. También puede considerarlo como la funcionalidad de una API REST. Como cualquier tipo de software, todo el paquete está versionado / actualizado, no funcionalidades o recursos únicos.
Su pregunta tendría sentido en el contexto donde los recursos del paquete REST API son modulares y, por lo tanto, potencialmente desarrollados y versionados por separado.
Luego, por lo que veo, las principales desventajas de su convención de nomenclatura del localizador de recursos propuesta:
- Para el usuario de la API , resultaría en localizadores de recursos mucho más complejos, menos predecibles, menos memorables y menos estables. Es más difícil recordar qué versión en particular se encuentra en cada recurso y conjunto de recursos ...
- Para el desarrollador (es) de módulos , ahora es más trabajo tener que lidiar con esta versión en su propio localizador de recursos.
- Los cambios en los localizadores de recursos se vuelven mucho más frecuentes, a medida que se actualizan varios módulos ... A largo plazo, los inconvenientes anteriores pueden ser lo suficientemente desagradables ...
Al crear una API, uno de sus principales objetivos es hacer que sea fácil de usar ...
¿Podría encontrar una mejor manera de introducir un cambio importante o incluso la versión de la API REST con un encabezado HTTP?
Para conocer un poco más sobre el enfoque de los encabezados HTTP, vea otras respuestas a continuación y: enlace