swagger introduction - the - whys
TRANSCRIPT
![Page 1: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/1.jpg)
GiovanniandJus,nonSwaggerandRAMLMikefromFlockDataonmicroservicesexperiencePizzaGetoutofhere
AucklandAPIandMicroservicesMeetup
I
3rdmee,ng
![Page 2: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/2.jpg)
IBMteam
Recep,onist
Security
Firewarden
Janitor
Safetybriefing• listofeveryone• attheendalloftheguestshavetoleave• healthandsafetyandemergency• bathroomsandtheemergencyexits• leavethemee,ngroomina,dystate• alcoholmustbemanagedresponsibly
![Page 3: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/3.jpg)
Introduc)on to SWAGGER (the whys)
GiovanniVigorelliIBMmiddleware
![Page 4: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/4.jpg)
Howonepresentshimorherselftotheworld.Swaggerisshownfromhowthepersonhandlesasitua,on.Itcanalsobeshownintheperson'swalk.
hMp://www.urbandic,onary.com/define.php?term=swagger
Canwestartwithoutadefini,on?
Aperson'sstyle-theywaytheywalk,talk,dress.I'mlovinghisswagger!
![Page 5: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/5.jpg)
It’sallaboutmakingthemselvesvisible
RESTWebAPIislikebrowsingawebsitewithyoureyesclosed!
Inthe‘olddays’orin‘theotherroom’there’sWSDL(SOAPwebservices),complexanduglyasyoulike,butupforthejob
![Page 6: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/6.jpg)
Whichproblemsittries(successfully)tosolve
APIdiscovery
APIreadability
Developmentspeedup-clientandserversidedecoupling-crea,ngRESTAPIfromyourcode-generatecodefromAPI
RemovebarriersbetweenBusiness(productowners)andIT(developers)
![Page 7: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/7.jpg)
Swagger.json
APIdiscovery(defini,on)
swagger
info
host
basePath
schemes
consumes
produces
paths
defini,ons (…orYAML)
![Page 8: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/8.jpg)
SwaggerUIhelpstodefineastandardforRESTAPIdocumenta,on.Nomoredocumenta,oncowboys!
APIreadability(documenta,on)
![Page 9: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/9.jpg)
APIdefini,onallowsclientsidedeveloperstocreateclientagainstswaggerdefini,on(codgenortest)
APIdefini,onallowsserversidedevelopersimplementthelogictoserverAPIresources
Dev.speedup–clientandserverdecoupling
BusinessServicesMobile,Web,whateverApps
Swagger.json
![Page 10: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/10.jpg)
Devspeedup–codegenera,on
SwaggerTools
SwaggerJS
SwaggerCodegen
![Page 11: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/11.jpg)
Dev.speedup–APIgenera,on
JAX-RS
![Page 12: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/12.jpg)
RemoveBusiness–Developmentbarriers
TopDownBoMomupIden,fy
commercialproducts
DesigntheAPI
ImplementtheAPIlogic
LeverageITlegacy
LeverageITlegacy
ExternalizeITassets
Marke,ngaproduct
![Page 13: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/13.jpg)
100%opensource,lovedbybigplayers
![Page 14: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/14.jpg)
SwaggerapiRAMLapi Blueprintapi
3players…
…1winner!(ifitwasarace)
![Page 15: Swagger introduction - the - whys](https://reader035.vdocuments.net/reader035/viewer/2022062316/58a00ef01a28ab9c418b4607/html5/thumbnails/15.jpg)
hMp://www.miramax.com/subscript/pulp-fic,on-celebra,ng-20-years/
Imagescredit:
hMps://en.wikipedia.org/wiki/Night_vision_device
hMp://swagger.io
hMps://maxpreme.wordpress.com/2008/12/08/the-north-face-x-swagger/
hMps://www.google.co.nz/trends/
hMp://www.telestar.fr/2014/photos/zach-galifianakis-l-incroyable-perte-de-poids-de-l-acteur-de-very-bad-trip-diaporama-49531
hMp://mic.com/ar,cles/77505/why-everyone-is-so-mad-about-the-wolf-of-wall-street#.GL46BT50a