Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Sign up for free
Menu
Search
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Features
All features
Private URLs
Password Protection
Custom URLS
Scheduled publishing
Remove Branding
Restrict embedding
Deck Collections
Notes
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Explore
Featured decks
Featured speakers
Programming
Technology
Storyboards
Pricing
Search
Sign in
Sign up for free
Where's Waldo: Building Better APIs with Swagger
Search
Sponsored
·
Your Podcast. Everywhere. Effortlessly.
Share. Educate. Inspire. Entertain. You do you. We'll handle the rest.
→
Natasha Carlyon
May 14, 2019
Research
44
0
Share
Embed
Copy iframe code
Copy JS code
Copy link
Start on current slide
Where's Waldo: Building Better APIs with Swagger
Natasha Carlyon
May 14, 2019
Transcript
10 slides
Where’s Waldo?: Building Better APIs with Swagger Natasha Carlyon
[email protected]
@nscarlyon
Natasha Carlyon • Software Crafter • https://www.greatersum.com/ • @nscarlyon •
http://speakerdeck.com/ •
[email protected]
Jeff Bezos Mandate
Jeff Bezos Mandate 6. Anyone who doesn't do this will
be fired.
Swagger
API Maturity Model • Level 0 • Level 1 •
Level 2 • Level 3 https://martinfowler.com/articles/richardsonMaturityModel.html
Hypertext • Roy Fielding • Discoverability • Flexibility
Status Codes • 200 (OK) • 201 (Created) • 202
(Accepted) • 204 (No Content) • 301 (Moved Permanently) • 303 (See Other) • 304 (Not Modified) • 400 (Bad Request) • 401 (Unauthorized) • 404 (Not Found) • 405 (Method Not Allowed) • 406 (Not Acceptable) • 409 (Conflict) • 500 (Server Error)
Resources • https://github.com/domaindrivendev/Swashb uckle.AspNetCore • https://github.com/Microsoft/aspnet-api-vers ioning
Natasha Carlyon • Software Crafter • https://www.greatersum.com/ • @nscarlyon •
http://speakerdeck.com/ •
[email protected]
More Decks by Natasha Carlyon
See All by Natasha Carlyon
Exploring The Digital Frontier: CSS Grid & Flexbox
nscarlyon
0
44
Upping_Your_Interviewing_Game.pdf
nscarlyon
0
65
DevOps
nscarlyon
0
34
ng g talk-on-angular-console
nscarlyon
0
140
Alexa, what is 2 + 2?
nscarlyon
0
140
Mob Programming
nscarlyon
0
320
Other Decks in Research
See All in Research
Détecter les vulnérabilités dans un environnement souverain
hellosct1
0
130
Top 4セキュリティ会議に一通り論文が採択されるまでの道のりと展望 / Top 4 Security Grand Slam
takaomurakami
0
1.1k
AI創薬の壁
kanojikajino
1
1.3k
MIRU2026 チュートリアル講演2:三次元データ処理の動向
nnchiba
8
5.6k
ros2-perf-multihost: Automated Coordination Framework for Objective Architecture Evaluation in Distributed Systems
takasehideki
0
180
[最先端NLP勉強会2026] Checklists Are Better Than Reward Models For Aligning Language Models
nzw0301
1
360
超効率化への挑戦:1bit LLMの現状と展望
yumaichikawa
1
1k
モデル評価を効率的にする方法
ftakahashi
0
250
SAM3を用いたコマ・吹き出しの 領域検出と分割構造からの読み順推定
kzmssk
0
240
Model Predictive Control for Uncertain Systems: Robust & Data-Driven Designs
kohlerjohannes
0
240
CDCL を用いた MILP の厳密解法
imai448
0
330
量子サマースクール2026「量子計算機アーキテクチャ分野の概観」
youten622
1
1k
Featured
See All Featured
RailsConf 2023
tenderlove
30
1.6k
The Organizational Zoo: Understanding Human Behavior Agility Through Metaphoric Constructive Conversations (based on the works of Arthur Shelley, Ph.D)
kimpetersen
PRO
0
550
Exploring anti-patterns in Rails
aemeredith
4
580
We Analyzed 250 Million AI Search Results: Here's What I Found
joshbly
2
2.1k
Automating Front-end Workflow
addyosmani
1370
210k
Breaking role norms: Why Content Design is so much more than writing copy - Taylor Woolridge
uxyall
2
540
[Rails World 2026] Durable orchestration on Rails: from continuation to workflow
palkan
4
1.3k
Money Talks: Using Revenue to Get Sh*t Done
nikkihalliwell
0
570
Embracing the Ebb and Flow
colly
88
5.2k
JavaScript: Past, Present, and Future - NDC Porto 2020
reverentgeek
52
6.2k
Everyday Curiosity
cassininazir
0
420
GitHub's CSS Performance
jonrohan
1033
470k