Creación de APIs REST con Spring Boot

Un controlador de Spring Boot se escribe en unos minutos. Por eso tantas APIs comparten el mismo defecto: se escribieron deprisa, funcionan, y el día en que hay que añadir un campo interno a una tabla se descubre que una aplicación móvil publicada el año pasado va a recibirlo.

El punto de inflexión de una API casi nunca es técnico. Es contractual. En cuanto un cliente consume vuestras respuestas, la forma de esas respuestas se convierte en un compromiso que ya no podéis modificar unilateralmente. La pregunta que decide todo lo demás es, por tanto, sencilla: ¿quién decide la forma del JSON? Si la respuesta es «la tabla», cada decisión de esquema pasa a ser una decisión de API, tomada por alguien que no pensaba en ello.

Esta lección construye el CRUD completo del catálogo de biblio-api y establece de paso la única frontera que importa: el modelo expuesto es un objeto aparte, escrito expresamente para el exterior e independiente del modelo almacenado. Todo lo demás —códigos de estado, paginación, versionado— se deriva de esta decisión.

Aquí trabajamos con un repositorio en memoria; la persistencia real llega en la lección siguiente. Así podemos tratar el diseño de la API sin distraernos con JPA.