VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES...

12
SWAGGER VEILLE TECHNOLOGIQUE ABDELAZIZ FOUNAS

Transcript of VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES...

Page 1: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

SWAGGERVEILLE TECHNOLOGIQUE

ABDELAZIZ FOUNAS

Page 2: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

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

Page 3: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

VEILLE TECHNOLOGIQUE - SWAGGER

I) VUE D’ENSEMBLE SUR SWAGGER

Documentations

Tests

Générations

d’API REST

OpenSource

3

Page 4: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

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

Page 5: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

VEILLE TECHNOLOGIQUE - SWAGGER

III) OUTILS SWAGGER

Swagger Core

Swagger Codegen

Swagger UI

Swagger Editor

Et plus …

5

Page 6: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

VEILLE TECHNOLOGIQUE - SWAGGER

IV) FORMATS SWAGGER

JSON

6

Page 7: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

VEILLE TECHNOLOGIQUE - SWAGGER

IV) FORMATS SWAGGER

YAML

7

Page 8: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

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

Page 9: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

VEILLE TECHNOLOGIQUE - SWAGGER

VI) CONCLUSION

Simple

Support

Indispensable

9

Page 10: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

VEILLE TECHNOLOGIQUE - SWAGGER

VII) DÉMONSTRATION

10

Page 11: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

MERCI POUR VOTRE ATTENTION !

AVEZ-VOUS DES QUESTIONS ?

VEILLE TECHNOLOGIQUE - SWAGGER 11

Page 12: VEILLE TECHNOLOGIQUE SWAGGER - imag · VEILLE TECHNOLOGIQUE - SWAGGER V) SOLUTIONS ALTERNATIVES RAML ‣ Les plus : constructions des metadatas avancées ‣ Les moins : manque des

VEILLE TECHNOLOGIQUE - SWAGGER

SOURCES

swagger.io

github.com/swagger-api/

raml.org

apiblueprint.org

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

12