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

Where's Waldo: Building Better APIs with Swagger

Avatar for Natasha Carlyon Natasha Carlyon
May 14, 2019
Research
0
31

Where's Waldo: Building Better APIs with Swagger

Avatar for Natasha Carlyon

Natasha Carlyon

May 14, 2019
Tweet

More Decks by Natasha Carlyon

See All by Natasha Carlyon
Exploring The Digital Frontier: CSS Grid & Flexbox
Avatar for Natasha Carlyon nscarlyon
0
29
Upping_Your_Interviewing_Game.pdf
Avatar for Natasha Carlyon nscarlyon
0
55
DevOps
Avatar for Natasha Carlyon nscarlyon
0
24
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
300

Other Decks in Research

See All in Research
2026年1月の生成AI領域の重要リリース＆トピック解説
Avatar for KAJI | 梶谷健人 kajikent
0
380
【NICOGRAPH2025】Photographic Conviviality: ボディペイント・ワークショップによる 同時的かつ共生的な写真体験
Avatar for Chinatsu Ozawa toremolo72
0
170
2026.01ウェビナー資料
Avatar for Elith elith
0
220
An Open and Reproducible Deep Research Agent for Long-Form Question Answering
Avatar for Ikuya Yamada ikuyamada
0
280
姫路市 -都市OSの「再実装」-
Avatar for Hopin hopin
0
1.6k
ドメイン知識がない領域での自然言語処理の始め方
Avatar for Hayahide Yamagishi hargon24
1
240
AIスーパーコンピュータにおけるLLM学習処理性能の計測と可観測性 / AI Supercomputer LLM Benchmarking and Observability
Avatar for Yuuki Tsubouchi (yuuk1) yuukit
1
660
SREはサイバネティクスの夢をみるか？ / Do SREs Dream of Cybernetics?
Avatar for Yuuki Tsubouchi (yuuk1) yuukit
3
390
CoRL2025速報
Avatar for robotpaper.challenge rpc
4
4.2k
第66回コンピュータビジョン勉強会＠関東 Epona: Autoregressive Diffusion World Model for Autonomous Driving
Avatar for Kento Sasaki kentosasaki
0
350
ブレグマン距離最小化に基づくリース表現量推定： バイアス除去学習の統一理論
Avatar for MasaKat0 masakat0
0
140
OWASP KansaiDAY 2025.09_文系OSINTハンズオン
Avatar for OWASP Kansai owaspkansai
0
110

Featured

See All Featured
Leo the Paperboy
Avatar for Maya Tellez mayatellez
4
1.4k
Rebuilding a faster, lazier Slack
Avatar for samanthasiow samanthasiow
85
9.4k
Navigating the moral maze — ethical principles for Al-driven product design
Avatar for Skipper Chong Warson skipperchong
2
250
Conquering PDFs: document understanding beyond plain text
Avatar for Ines Montani inesmontani
PRO
4
2.3k
<Decoding/> the Language of Devs - We Love SEO 2024
Avatar for Nikki Halliwell nikkihalliwell
1
130
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
Avatar for panda_program panda_program
122
21k
Reality Check: Gamification 10 Years Later
Avatar for Sebastian Deterding codingconduct
0
2k
Groundhog Day: Seeking Process in Gaming for Health
Avatar for Sebastian Deterding codingconduct
0
96
Building Applications with DynamoDB
Avatar for Matt Wood mza
96
6.9k
Color Theory Basics | Prateek | Gurzu
Avatar for Gurzu gurzu
0
200
Done Done
Avatar for chrislema chrislema
186
16k
CSS Pre-Processors: Stylus, Less & Sass
Avatar for Bermon Painter bermonpainter
359
30k

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]