SlideShare a Scribd company logo
1 of 15
Download to read offline
Giovanni	and	Jus,n	on	Swagger	and	RAML	
	
Mike	from	FlockData	on	microservices	experience		
	
Pizza	
	
Get	out	of	here	
Auckland	API	and	Microservices	Meetup	
I	
3rd		mee,ng
IBM	team	
Recep,onist	
Security	
Fire	warden	
	
Janitor	
Safety	briefing	
	
•  list	of	everyone		
•  at	the	end	all	of	the	guests	have	to	leave	
•  health	and	safety	and	emergency		
•  bathrooms	and	the	emergency	exits		
•  leave	the	mee,ng	room	in	a	,dy	state	
•  alcohol	must	be	managed	responsibly
Introduc)on to 
SWAGGER
(the whys) 
Giovanni	Vigorelli	
IBM	middleware
How	one	presents	him	or	her	self	to	the	world.	
Swagger	is	shown	from	how	the	person	
handles	a	situa,on.	It	can	also	be	shown	in	the	
person's	walk.	
hMp://www.urbandic,onary.com/define.php?term=swagger	
Can	we	start	without	a	defini,on?	
A	person's	style-	they	way	they	walk,	talk,	dress.	
I'm	loving	his	swagger!
It’s	all	about	making	themselves	visible	
REST	Web	API	is	like	browsing	a	web	
site	with	your	eyes	closed!	
In	the	‘old	days’	or	in	‘the	other	room’	there’s	WSDL	
(SOAP	web	services),	complex	and	ugly	as	you	like,	
but	up	for	the	job
Which	problems	it	tries	(successfully)	to	solve	
API	discovery	
API	readability	
Development	speed	up	
	-	client	and	server	side	decoupling	
	-	crea,ng	REST	API	from	your	code	
	-	generate	code	from	API	
Remove	barriers	
between	Business	
(product	owners)	and	IT	
(developers)
Swagger.json	
API	discovery	(defini,on)	
swagger	
info	
host	
basePath	
schemes	
consumes	
produces	
paths	
defini,ons	
(…	or	YAML)
Swagger	UI	helps	to	define	a	standard	for	REST	API	documenta,on.	
	
No	more	documenta,on	cowboys	!	
API	readability	(documenta,on)
API	defini,on	allows	client	side	
developers	to	create	client	against	
swagger	defini,on		(codgen	or	test)	
API	defini,on	allows	server	side	
developers	implement	the	logic	to	server	
API	resources	
Dev.	speed	up	–	client	and	server	decoupling	
Business	Services	Mobile,	Web,	
whatever	Apps	
	
S
w
a
g
g
e
r	.
j
s
o
n
Dev	speed	up	–	code	genera,on	
Swagger	Tools	
Swagger	JS	
Swagger	Codegen
Dev.	speed	up	–	API	genera,on	
JAX-RS
Remove	Business	–	Development	barriers	
Top	Down	BoMom	up	
Iden,fy	
commercial	
products	
Design	the	API	
Implement	the	
API	logic	
Leverage	IT	legacy	
Leverage	IT	legacy	
Externalize	IT	
assets	
Marke,ng	a	
product
100%	open	source,	loved	by	big	players
Swagger	api	RAML	api	 Blueprint	api	
3	players…		
…	1	winner!	
(if	it	was	a	race)
hMp://www.miramax.com/subscript/pulp-fic,on-celebra,ng-20-years/	
Images	credit:	
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

More Related Content

Viewers also liked (12)

Another API-Blueprint, RAML and Swagger Comparison
Another API-Blueprint, RAML and Swagger ComparisonAnother API-Blueprint, RAML and Swagger Comparison
Another API-Blueprint, RAML and Swagger Comparison
 
Babesia
BabesiaBabesia
Babesia
 
Babesiosis
BabesiosisBabesiosis
Babesiosis
 
Bovine Mastitis
Bovine MastitisBovine Mastitis
Bovine Mastitis
 
viral hepatitis- facts and treatment guidelines.
viral hepatitis- facts and treatment guidelines.viral hepatitis- facts and treatment guidelines.
viral hepatitis- facts and treatment guidelines.
 
Hepatitis b virus (hbv)
Hepatitis b virus (hbv)Hepatitis b virus (hbv)
Hepatitis b virus (hbv)
 
laboratory diagnosis of viral hepatitis (B & C)
laboratory diagnosis of viral hepatitis (B & C)laboratory diagnosis of viral hepatitis (B & C)
laboratory diagnosis of viral hepatitis (B & C)
 
Fazd bovine babesiosis final slideshow 29 jul
Fazd bovine babesiosis final slideshow 29 julFazd bovine babesiosis final slideshow 29 jul
Fazd bovine babesiosis final slideshow 29 jul
 
Viral hepatitis
Viral hepatitisViral hepatitis
Viral hepatitis
 
Hepatitis B
Hepatitis BHepatitis B
Hepatitis B
 
Hepatitis B Virus
Hepatitis B VirusHepatitis B Virus
Hepatitis B Virus
 
Hepatitis ppt final
Hepatitis ppt finalHepatitis ppt final
Hepatitis ppt final
 

Recently uploaded

%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...
%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...
%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...
masabamasaba
 
%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...
%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...
%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...
masabamasaba
 
%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...
%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...
%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...
masabamasaba
 
%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...
%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...
%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...
masabamasaba
 
+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...
+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...
+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...
Health
 

Recently uploaded (20)

%in kaalfontein+277-882-255-28 abortion pills for sale in kaalfontein
%in kaalfontein+277-882-255-28 abortion pills for sale in kaalfontein%in kaalfontein+277-882-255-28 abortion pills for sale in kaalfontein
%in kaalfontein+277-882-255-28 abortion pills for sale in kaalfontein
 
%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...
%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...
%+27788225528 love spells in Huntington Beach Psychic Readings, Attraction sp...
 
%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...
%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...
%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...
 
tonesoftg
tonesoftgtonesoftg
tonesoftg
 
Crypto Cloud Review - How To Earn Up To $500 Per DAY Of Bitcoin 100% On AutoP...
Crypto Cloud Review - How To Earn Up To $500 Per DAY Of Bitcoin 100% On AutoP...Crypto Cloud Review - How To Earn Up To $500 Per DAY Of Bitcoin 100% On AutoP...
Crypto Cloud Review - How To Earn Up To $500 Per DAY Of Bitcoin 100% On AutoP...
 
%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...
%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...
%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...
 
%in Benoni+277-882-255-28 abortion pills for sale in Benoni
%in Benoni+277-882-255-28 abortion pills for sale in Benoni%in Benoni+277-882-255-28 abortion pills for sale in Benoni
%in Benoni+277-882-255-28 abortion pills for sale in Benoni
 
WSO2CON 2024 - Cloud Native Middleware: Domain-Driven Design, Cell-Based Arch...
WSO2CON 2024 - Cloud Native Middleware: Domain-Driven Design, Cell-Based Arch...WSO2CON 2024 - Cloud Native Middleware: Domain-Driven Design, Cell-Based Arch...
WSO2CON 2024 - Cloud Native Middleware: Domain-Driven Design, Cell-Based Arch...
 
%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...
%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...
%+27788225528 love spells in Boston Psychic Readings, Attraction spells,Bring...
 
WSO2CON 2024 - API Management Usage at La Poste and Its Impact on Business an...
WSO2CON 2024 - API Management Usage at La Poste and Its Impact on Business an...WSO2CON 2024 - API Management Usage at La Poste and Its Impact on Business an...
WSO2CON 2024 - API Management Usage at La Poste and Its Impact on Business an...
 
WSO2CON 2024 - WSO2's Digital Transformation Journey with Choreo: A Platforml...
WSO2CON 2024 - WSO2's Digital Transformation Journey with Choreo: A Platforml...WSO2CON 2024 - WSO2's Digital Transformation Journey with Choreo: A Platforml...
WSO2CON 2024 - WSO2's Digital Transformation Journey with Choreo: A Platforml...
 
%in Soweto+277-882-255-28 abortion pills for sale in soweto
%in Soweto+277-882-255-28 abortion pills for sale in soweto%in Soweto+277-882-255-28 abortion pills for sale in soweto
%in Soweto+277-882-255-28 abortion pills for sale in soweto
 
WSO2CON 2024 - Freedom First—Unleashing Developer Potential with Open Source
WSO2CON 2024 - Freedom First—Unleashing Developer Potential with Open SourceWSO2CON 2024 - Freedom First—Unleashing Developer Potential with Open Source
WSO2CON 2024 - Freedom First—Unleashing Developer Potential with Open Source
 
WSO2CON2024 - It's time to go Platformless
WSO2CON2024 - It's time to go PlatformlessWSO2CON2024 - It's time to go Platformless
WSO2CON2024 - It's time to go Platformless
 
WSO2Con204 - Hard Rock Presentation - Keynote
WSO2Con204 - Hard Rock Presentation - KeynoteWSO2Con204 - Hard Rock Presentation - Keynote
WSO2Con204 - Hard Rock Presentation - Keynote
 
+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...
+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...
+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...
 
Devoxx UK 2024 - Going serverless with Quarkus, GraalVM native images and AWS...
Devoxx UK 2024 - Going serverless with Quarkus, GraalVM native images and AWS...Devoxx UK 2024 - Going serverless with Quarkus, GraalVM native images and AWS...
Devoxx UK 2024 - Going serverless with Quarkus, GraalVM native images and AWS...
 
VTU technical seminar 8Th Sem on Scikit-learn
VTU technical seminar 8Th Sem on Scikit-learnVTU technical seminar 8Th Sem on Scikit-learn
VTU technical seminar 8Th Sem on Scikit-learn
 
WSO2Con2024 - From Code To Cloud: Fast Track Your Cloud Native Journey with C...
WSO2Con2024 - From Code To Cloud: Fast Track Your Cloud Native Journey with C...WSO2Con2024 - From Code To Cloud: Fast Track Your Cloud Native Journey with C...
WSO2Con2024 - From Code To Cloud: Fast Track Your Cloud Native Journey with C...
 
WSO2CON 2024 - Does Open Source Still Matter?
WSO2CON 2024 - Does Open Source Still Matter?WSO2CON 2024 - Does Open Source Still Matter?
WSO2CON 2024 - Does Open Source Still Matter?
 

Swagger introduction - the - whys