Lock in $30 Savings on PRO—Offer Ends Soon! ⏳

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
製造業主導型経済からサービス経済化における中間層形成メカニズムのパラダイムシフト
Avatar for Masatake Yamoto yamotty
0
290
AIスパコン「さくらONE」の
オブザーバビリティ / Observability for AI Supercomputer SAKURAONE
Avatar for Yuuki Tsubouchi (yuuk1) yuukit
2
1k
Mamba-in-Mamba: Centralized Mamba-Cross-Scan in Tokenized Mamba Model for Hyperspectral Image Classification
Avatar for SatAI.challenge satai
3
310
CVPR2025論文紹介：Unboxed
Avatar for 村川卓也 murakawatakuya
0
230
令和最新技術で伝統掲示板を再構築: HonoX で作る型安全なスレッドフロート型掲示板 / かろっく@calloc134 - Hono Conference 2025
Avatar for calloc134 calloc134
0
450
Sat2City:3D City Generation from A Single Satellite Image with Cascaded Latent Diffusion
Avatar for SatAI.challenge satai
4
360
説明可能な機械学習と数理最適化
Avatar for kelicht kelicht
2
740
Pythonでジオを使い倒そう！ 〜それとFOSS4G Hiroshima 2026のご紹介を少し〜
Avatar for wata909 wata909
0
1.2k
When Learned Data Structures Meet Computer Vision
Avatar for Yusuke Matsui matsui_528
1
1.5k
Agentic AI フレームワーク戦略白書 (2025年度版）
Avatar for MIKIO KUBO mickey_kubo
1
100
EarthDial: Turning Multi-sensory Earth Observations to Interactive Dialogues
Avatar for SatAI.challenge satai
3
430
20250725-bet-ai-day
Avatar for cipepser cipepser
3
550

Featured

See All Featured
How to Grow Your eCommerce with AI & Automation
Avatar for Katarina Dahlin katarinadahlin
PRO
0
67
Rails Girls Zürich Keynote
Avatar for Gregor Martynus gr2m
95
14k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
Avatar for panda_program panda_program
122
21k
The Language of Interfaces
Avatar for Des Traynor destraynor
162
25k
Utilizing Notion as your number one productivity tool
Avatar for Mfonobong Umondia mfonobong
2
180
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
Avatar for Marc Duiker marcduiker
35
2.3k
From Legacy to Launchpad: Building Startup-Ready Communities
Avatar for Dug Song dugsong
0
110
Google's AI Overviews - The New Search
Avatar for Barry Adams badams
0
860
The innovator’s Mindset - 
Leading Through an Era of Exponential Change - McGill University 2025
Avatar for Jean-Marc De Jonghe jdejongh
PRO
1
63
A Guide to Academic Writing Using Generative AI - A Workshop
Avatar for Kenji Saito ks91
PRO
0
160
Taking LLMs out of the black box: A practical guide to human-in-the-loop distillation
Avatar for Ines Montani inesmontani
PRO
3
1.9k
First, design no harm
Avatar for Per Axbom axbom
PRO
1
1k

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]