Jeremie Bresson | Voxxed Days

Voxxed Days Luxembourg 2019
from Thursday 20 June to Friday 21 June 2019.

I am a software developer and an open-source enthusiastic. In my spare time I contribute different open source projects. I like learning new technologies and helping people with it. I am an enthusiastic Eclipse IDE user and I like the documentation as code approach.

See also http://jmini.github.io/

Utiliser OpenAPI plutôt qu’un document html quelconque pour décrire son API

Quickie

Une spécification OpenAPI (anciennement connu sous le nom de Swagger) permet de décrire une API REST. C’est un format standard, lisible par une machine et indépendant de tout langage de programmation. C’est un projet open-source hébergé par la fondation Linux.

Cette présentation est un retour d’expérience qui montre comment nous sommes passé d’un format standard pour documenter notre API à l’utilisation d’OpenAPI. Les bénéfices sont nombreux:

  • Integration avec d’autres outils (postman ou des générateurs de code)
  • Possibilité de détecter des breaking-changes lors des évolutions d’API

Les approches “spec-first” ou “code-first” présentent chacun des avantages et des inconvénients qui seront également exposés.

Les exemples de codes sont open-source, hébergés sur GitHub.

Sign-in
Make sure to download the Android or iOS mobile schedule.