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
27

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
24
Upping_Your_Interviewing_Game.pdf
Avatar for Natasha Carlyon nscarlyon
0
53
DevOps
Avatar for Natasha Carlyon nscarlyon
0
23
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
290

Other Decks in Research

See All in Research
AIによる画像認識技術の進化 -25年の技術変遷を振り返る-
Avatar for Hironobu Fujiyoshi hf149
7
3.9k
業界横断 副業・兼業者の実態調査
Avatar for fkske fkske
0
220
Generative Models 2025
Avatar for Hiroshi Takahashi takahashihiroshi
24
13k
最適決定木を用いた処方的価格最適化
Avatar for MIKIO KUBO mickey_kubo
4
1.8k
ストレス計測方法の確立に向けたマルチモーダルデータの活用
Avatar for Yuriko Kikuchi yurikomium
0
1.1k
A multimodal data fusion model for accurate and interpretable urban land use mapping with uncertainty analysis
Avatar for SatAI.challenge satai
3
260
20250502_ABEJA_論文読み会_スライド
Avatar for Tomoki Fujihara flatton
0
190
Towards a More Efficient Reasoning LLM: AIMO2 Solution Summary and Introduction to Fast-Math Models
Avatar for Hiroshechka Y analokmaus
2
730
2025/7/5 応用音響研究会招待講演＠北海道大学
Avatar for Takuma OKAMOTO takuma_okamoto
1
160
多言語カスタマーインタビューの“壁”を越える~PMと生成AIの共創~ 株式会社ジグザグ 松野 亘
Avatar for Wataru Matsuno watarumatsuno
0
110
研究テーマのデザインと研究遂行の方法論
Avatar for Hisashi Ishihara hisashiishihara
5
1.6k
集合間Bregmanダイバージェンスと置換不変NNによるその学習
Avatar for Takahiro Kawashima wasyro
0
130

Featured

See All Featured
Dealing with People You Can't Stand - Big Design 2015
Avatar for Cassini Nazir cassininazir
367
26k
How to Think Like a Performance Engineer
Avatar for Harry Roberts csswizardry
25
1.8k
Making the Leap to Tech Lead
Avatar for Ryan Cromwell cromwellryan
134
9.5k
The Power of CSS Pseudo Elements
Avatar for Geoffrey Crofte geoffreycrofte
77
5.9k
Learning to Love Humans: Emotional Interface Design
Avatar for Aarron Walter aarron
273
40k
What's in a price? How to price your products and services
Avatar for Michael Herold michaelherold
246
12k
Gamification - CAS2011
Avatar for David Bonilla davidbonilla
81
5.4k
Building a Scalable Design System with Sketch
Avatar for Laura Van Doore lauravandoore
462
33k
CoffeeScript is Beautiful & I Never Want to Write Plain JavaScript Again
Avatar for Sam Stephenson sstephenson
161
15k
The MySQL Ecosystem @ GitHub 2015
Avatar for Sam Lambert samlambert
251
13k
Put a Button on it: Removing Barriers to Going Fast.
Avatar for kastner kastner
60
4k
Bash Introduction
Avatar for André Augusto Costa Santos 62gerente
614
210k

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]