SWAGGERVEILLE TECHNOLOGIQUE

ABDELAZIZ FOUNAS

VEILLE TECHNOLOGIQUE - SWAGGER 2

I) Vue d’ensemble sur Swagger

II) API REST

III) Outils Swagger

IV) Formats Swagger

V) Solutions alternatives

VI) Conclusion

VII) Démonstration

PLAN

VEILLE TECHNOLOGIQUE - SWAGGER

I) VUE D’ENSEMBLE SUR SWAGGER

Documentations

Tests

Générations

d’API REST

OpenSource

3

VEILLE TECHNOLOGIQUE - SWAGGER

II) API REST

Style d’architecture

Créé par Roy Fielding en 2000

Utilisation de HTTP

Plusieurs langages et plateformes

JAX-RS en Java et Jersey

4

VEILLE TECHNOLOGIQUE - SWAGGER

III) OUTILS SWAGGER

Swagger Core

Swagger Codegen

Swagger UI

Swagger Editor

Et plus …

5

VEILLE TECHNOLOGIQUE - SWAGGER

IV) FORMATS SWAGGER

JSON

6

VEILLE TECHNOLOGIQUE - SWAGGER

IV) FORMATS SWAGGER

YAML

7

VEILLE TECHNOLOGIQUE - SWAGGER

V) SOLUTIONS ALTERNATIVES

RAML

‣ Les plus : constructions des metadatas avancées

‣ Les moins : manque des outils au niveau du code

API Blueprint

‣ Les plus : facile à comprendre

‣ Les moins : installation complexe

8

VEILLE TECHNOLOGIQUE - SWAGGER

VI) CONCLUSION

Simple

Support

Indispensable

9

VEILLE TECHNOLOGIQUE - SWAGGER

VII) DÉMONSTRATION

10

MERCI POUR VOTRE ATTENTION !

AVEZ-VOUS DES QUESTIONS ?

VEILLE TECHNOLOGIQUE - SWAGGER 11

VEILLE TECHNOLOGIQUE - SWAGGER

SOURCES

swagger.io

github.com/swagger-api/

raml.org

apiblueprint.org

nordicapis.com/top-specification-formats-for-rest-apis/

12