OpenAPI (dev tools)

Les contrats OpenAPI (anciennement Swagger) permettent de formaliser le fonctionnement d’une API REST. Dans un environnement de plus en plus tourné vers les API et les micro-services, ce formalisme présente de nombreux avantages, comme la génération automatique du code client et serveur, la garantie de stabilité de l’écosystème, la validation à la volée des requêtes entrantes, la génération de documentation, etc.

Durant ce talk, nous vous présenterons la stratégie mise en place à Lyra pour centraliser et partager les contrats OpenAPI entre les différents produits, et simplifier les interdépendances entre services.

Pour cela, nous avons publié en Open-Source l’ « OpenAPI Dev Tool », un outil tout-en-un permettant de simplifier le développement et l’utilisation des contrats de nos API. Utilisé par tous nos projets en interne, il peut être utilisé dans n’importe quel contexte.

Enfin, nous conclurons par un retour d’expérience sur l’utilisation de l’écosystème OpenAPI, ses avantages et les pièges que nos 5 ans d’expérimentations nous ont permis de déceler.