J’ai publié sur le site de onepoint un livre blanc consacré à la conception d’API évolutives. Une API (Application Programming Interface, interface de programmation applicative) est le point d’entrée par lequel une application expose ses fonctionnalités à d’autres applications. Le livre blanc défend une idée simple : la qualité et la durabilité d’une API tiennent d’abord à sa simplicité et à la capacité d’abstraction de son concepteur. Il s’adresse aux API Designers, aux architectes et aux équipes qui conçoivent les interfaces d’un système d’information (SI).
Comment concevoir des API évolutives ?
À mesure qu’une API gagne en fonctionnalités, sa compréhension globale se fragilise et chaque évolution devient plus risquée. Le livre blanc propose de répondre à cette complexité par la simplicité et par l’abstraction. Il est construit autour de six questions que se pose tout concepteur d’API :
- Comment limiter strictement la surface de couplage d’une API à l’essentiel ?
- Comment faire exécuter des traitements complexes derrière une interface simple ?
- Comment structurer une API pour cacher les choix d’implémentation susceptibles d’évoluer ?
- Comment segmenter les consommateurs d’une API pour limiter leur couplage indirect ?
- Comment concevoir des interfaces génériques tout en adressant les spécificités métiers ?
- Comment stabiliser le contrat d’une API pour neutraliser l’impact des évolutions ?
Ce qu’il faut retenir
- La simplicité et l’abstraction sont les deux leviers d’une conception d’API qui résiste au temps.
- Une API bien conçue expose une interface simple et stable, tout en cachant la complexité et les choix d’implémentation susceptibles de changer.
- Le livre blanc réunit six principes concrets pour concevoir des API durables, évolutives et centrées sur l’utilisateur.
Le livre blanc se télécharge sur le site de onepoint, depuis sa page de présentation : API Designer : 6 principes clés pour booster l’évolutivité du SI.