KRQ-3526 Utiliser OpenAPI plutôt qu’un document html quelconque pour décrire son API | Voxxed Days

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

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

Quickie

Server Side
Server Side
Beginner & novice level
NT Friday from 13:15 til 13:30

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.

API   REST API   MicroProfile   Spring   Linux Foundation  
Subscribe to Voxxed Days on YouTube
Jeremie Bresson
Jeremie Bresson
From Unblu inc.

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.


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