Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Where's Waldo: Building Better APIs with Swagger

Sponsored · Your Podcast. Everywhere. Effortlessly. Share. Educate. Inspire. Entertain. You do you. We'll handle the rest. →
Avatar for Natasha Carlyon Natasha Carlyon
May 14, 2019
Research
38
0

Where's Waldo: Building Better APIs with Swagger

Avatar for Natasha Carlyon

Natasha Carlyon

May 14, 2019

More Decks by Natasha Carlyon

See All by Natasha Carlyon
Exploring The Digital Frontier: CSS Grid & Flexbox
Avatar for Natasha Carlyon nscarlyon
0
33
Upping_Your_Interviewing_Game.pdf
Avatar for Natasha Carlyon nscarlyon
0
56
DevOps
Avatar for Natasha Carlyon nscarlyon
0
25
ng g talk-on-angular-console
Avatar for Natasha Carlyon nscarlyon
0
140
Alexa, what is 2 + 2?
Avatar for Natasha Carlyon nscarlyon
0
110
Mob Programming
Avatar for Natasha Carlyon nscarlyon
0
310

Other Decks in Research

See All in Research
【SIGGRAPH Asia 2025】Lo-Fi Photograph with Lo-Fi Communication
Avatar for Chinatsu Ozawa toremolo72
0
160
ブレグマン距離最小化に基づくリース表現量推定： バイアス除去学習の統一理論
Avatar for MasaKat0 masakat0
0
260
RS-Agent: Automating Remote Sensing Tasks through Intelligent Agent
Avatar for SatAI.challenge satai
0
100
通時的な類似度行列に基づく単語の意味変化の分析
Avatar for hajime kiyama rudorudo11
0
280
言語モデルから言語について語る際に押さえておきたいこと
Avatar for Sho Yokoi eumesy
PRO
5
2.2k
CyberAgent AI Lab研修 / Social Implementation Anti-Patterns in AI Lab
Avatar for chck chck
6
4.4k
typst の使い方：言語学を研究する学生のために
Avatar for Tomoya gitomochang
0
420
2026年1月の生成AI領域の重要リリース＆トピック解説
Avatar for KAJI | 梶谷健人 kajikent
0
1k
ScoreMatchingRiesz for Automatic Debiased Machine Learning and Policy Path Estimation with an Application to Japanese Monetary Policy Evaluation
Avatar for MasaKat0 masakat0
0
270
[チュートリアル] 電波マップ構築入門 ：研究動向と課題設定の勘所
Avatar for Koya SATO k_sato
0
430
AIエージェント時代のLLM-jpモデルのあるべき姿
Avatar for Kouta Nakayama k141303
0
350
AY 2026 Guide to Academic Writing Using Generative AI - Workshop
Avatar for Kenji Saito ks91
PRO
0
110

Featured

See All Featured
Mozcon NYC 2025: Stop Losing SEO Traffic
Avatar for Sam Torres samtorres
0
230
Claude Code のすすめ
Avatar for schroneko schroneko
67
220k
The Organizational Zoo: Understanding Human Behavior Agility Through Metaphoric Constructive Conversations (based on the works of Arthur Shelley, Ph.D)
Avatar for Dr. Kim W Petersen kimpetersen
PRO
0
330
Self-Hosted WebAssembly Runtime for Runtime-Neutral Checkpoint/Restore in Edge–Cloud Continuum
Avatar for Yuki Nakata chikuwait chikuwait
0
530
Game over? The fight for quality and originality in the time of robots
Avatar for Wayne Barker wayneb77
1
170
From π to Pie charts
Avatar for Rasagy Sharma rasagy
0
180
Ten Tips & Tricks for a 🌱 transition
Avatar for Manu Carrasco Molina stuffmc
0
110
Typedesign – Prime Four
Avatar for Hannes Fritz hannesfritz
42
3k
VelocityConf: Rendering Performance Case Studies
Avatar for Addy Osmani addyosmani
333
25k
From Legacy to Launchpad: Building Startup-Ready Communities
Avatar for Dug Song dugsong
0
210
HDC tutorial
Avatar for Michiel Stock michielstock
2
660
The Mindset for Success: Future Career Progression
Avatar for Greg Gifford greggifford
PRO
0
330

Transcript

  1. Where’s Waldo?: Building Better APIs with Swagger Natasha Carlyon [email protected]

    @nscarlyon

  2. Natasha Carlyon • Software Crafter • https://www.greatersum.com/ • @nscarlyon •

    http://speakerdeck.com/ • [email protected]

  3. Jeff Bezos Mandate

  4. Jeff Bezos Mandate 6. Anyone who doesn't do this will

    be fired.

  5. Swagger

  6. API Maturity Model • Level 0 • Level 1 •

    Level 2 • Level 3 https://martinfowler.com/articles/richardsonMaturityModel.html

  7. Hypertext • Roy Fielding • Discoverability • Flexibility

  8. 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)

  9. Resources • https://github.com/domaindrivendev/Swashb uckle.AspNetCore • https://github.com/Microsoft/aspnet-api-vers ioning

  10. Natasha Carlyon • Software Crafter • https://www.greatersum.com/ • @nscarlyon •

    http://speakerdeck.com/ • [email protected]