Création d'API REST avec Spring Boot

Un contrôleur Spring Boot s'écrit en quelques minutes. C'est la raison pour laquelle tant d'API partagent le même défaut : elles ont été écrites vite, elles fonctionnent, et le jour où il faut ajouter un champ interne à une table, on découvre qu'une application mobile publiée l'an dernier va le recevoir.

Le point de bascule d'une API n'est presque jamais technique. Il est contractuel. Dès qu'un client consomme vos réponses, la forme de ces réponses devient un engagement que vous ne pouvez plus modifier unilatéralement. La question qui décide de la suite est donc simple : qui décide de la forme du JSON ? Si la réponse est « la table », alors chaque décision de schéma devient une décision d'API, prise par quelqu'un qui n'y pensait pas.

Cette leçon construit le CRUD complet du catalogue de biblio-api, et pose au passage la seule frontière qui compte : le modèle exposé est un objet à part, écrit exprès pour l'extérieur, indépendant du modèle stocké. Tout le reste — codes de statut, pagination, versionnage — découle de cette décision.

Nous travaillons ici avec un dépôt en mémoire ; la vraie persistance arrive à la leçon suivante. Cela permet de traiter la conception de l'API sans être distrait par JPA.