Swagger, OpenAPI ou OpenAPI Spec ?
Dans le monde de la description d'API, on entend souvent parler de Swagger, d'OpenAPI ou d'OpenAPI Spec. Mais qui est qui ? Et surtout, que choisir ? (more…)
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…