Swagger est mort, vive l’Open API Initiative !

Aujourd’hui, nous n’allons pas parler de RAML mais plutôt de Swagger. Ce framework se compose d’une spécification ainsi qu’un ensemble d’implémentations pour décrire, produire, consommer et visualiser des APIs RESTful. Même si l’adoption de RAML progresse, Swagger reste la solution la plus connue et répandue pour documenter vos APIs RESTful. Ce ne sont d’ailleurs pas les seules solutions car il existe bien d’autres DSL d’APIs RESTful.
Alors que RAML permet d’avoir une approche Top-Down (Contract-First), Swagger est initialement orienté Bottom-Up (Code First). Il existe quelques comparatifs (un qui commence à dater et un plus récent) entre les 3 leaders : Swagger, RAML et API Blueprint.
La Linux Foundation a annoncé la création de l’Open API Initiative dont l’objectif est d’élaborer des spécifications standards qui fourniront des métadonnées RESTful pour les APIs. Cette initiative est supportée dans des géants du web et des acteurs majeurs de la gestion d’APIs. Par la même occasion, Swagger intègre l’OAI et devient l’Open API Definition Format (OADF) (plus d’information).
Après la publication de RAML 1.0 et maintenant une initiative pour créer un standard autour de Swagger, il est de plus en plus évident que la documentation des APIs RESTful est un enjeu important et que la compétition ne fait que commencer !
https://blog.lecacheur.com/2015/12/16/swagger-est-mort-vive-lopen-api-initiative/https://blog.lecacheur.com/wp-content/uploads/2015/12/oai.pnghttps://blog.lecacheur.com/wp-content/uploads/2015/12/oai-150x150.pngConceptionDéveloppementapi,rest,swaggerAujourd'hui, nous n'allons pas parler de RAML mais plutôt de Swagger. Ce framework se compose d'une spécification ainsi qu'un ensemble d'implémentations pour décrire, produire, consommer et visualiser des APIs RESTful. Même si l'adoption de RAML progresse, Swagger reste la solution la plus connue et répandue pour documenter vos APIs...SeBSébastien LECACHEUR23r0@laposte.netAdministratorLe weblogue de SeB
Bonjour Seb
en relisant votre post je me suis dit que vous seriez peut-être intéressé par notre outil autoswagger qui génère des swaggers directement depuis un mindmapping. L’intérêt c’est de pouvoir travailler avec les gens du métier en mode mindmap, puis avec les informaticiens avec swagger
https://autoswagger.com
Si ça vous plait je vous arrangerai une utilisation gratuite.
Anselme, CTO de APIZR