Améliorons la qualité et l'adoption de nos API grâce à l'approche API-First

Et si la prochaine innovation dans le monde des API était l' Expérience Développeur ? Lorsqu'on souhaite développer des API, nous opposons régulièrement les approches Code-First et API-First. La plupart des développeurs préfèrent la première car elle est plus centrée sur le code. Malheureusement, de la seconde on ne retient trop souvent que les mots "documentations" ou "spécifications". Cette dernière offre cependant de nombreux avantages : compatibilité automatique des implémentations avec les spécifications, automatisation de la validation des API publiées et surtout, amélioration de l'expérience développeur de vos clients. Dans ce workshop, nous transformerons une application Java en la rendant "API-First" avec des pratiques et outils que j'ai pu mettre en oeuvre dans mes récentes expériences tels que la spécification JsonAPI ou les outils proposés par l'OpenAPI Initiative (OpenAPI Generator, OASDIFF,Microcks). Nous verrons enfin comment relever ce grand défi : simplifier vos développements, améliorer la qualité de vos API, favoriser son adoption par vos clients et, surtout, faire en sorte que vos développeurs puissent adorer manipuler de la documentation d'API.