¿Cómo se ajusta la API REST a las historias de usuario?

Como bien sabemos, hay una serie de requisitos que la API REST y el microservicio en general deben cumplir, los cuáles pueden verse aquí.

Para ello, la API REST se ha diseñado de forma que sea sencilla de utilizar y para que permita llevar a cabo estos requerimientos de una manera bastante intuitiva.

Las rutas del vocabulario tienen la estructura /tipo/palabra, donde tipo es alguno de los permitidos y palabra la palabra que forma parte del vocabulario. Estas rutas representan elementos individuales. Sobre estas rutas, se pueden hacer las siguientes operaciones:

Para ajustarse a los requisitos, la API REST permite acceder a vocabulario que tiene el mismo tipo, utilizando para ello rutas con la forma /tipo. Este tipo de rutas permite obtener un conjunto de vocabulario del mismo tipo, si es que existe alguno. Por tanto, la única petición que soporta es un GET a la ruta /tipo correpsondiente, devolviendo como respuesta todos los elementos del vocabulario que puedan ser encontrados con ese tipo.