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
39
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
34
Upping_Your_Interviewing_Game.pdf
Avatar for Natasha Carlyon nscarlyon
0
56
DevOps
Avatar for Natasha Carlyon nscarlyon
0
26
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
CyberAgent AI Lab研修 / Social Implementation Anti-Patterns in AI Lab
Avatar for chck chck
7
4.6k
事後確率分布の共分散について
Avatar for koide3 koide3
0
100
typst の使い方：言語学を研究する学生のために
Avatar for Tomoya gitomochang
0
450
Claude Code × autoresearch 実践
Avatar for 数理の弾丸 mathbullet
0
160
進学校の生徒にはア行の苗字が多いのか
Avatar for Takashi Ozeki ozekinote
0
440
Model Discovery and Graph Simulation: A Lightweight Gateway to Chaos Engineering
Avatar for Anatoly A. Krasnovsky anatolykr
0
190
FUSE-RSVLM: Feature Fusion Vision-Language Model for Remote Sensing
Avatar for SatAI.challenge satai
3
860
Using our influence and power for patient safety
Avatar for Helen Bevan helenbevan
0
360
National high-resolution cropland classification of Japan with agricultural census information and multi-temporal multi-modality datasets
Avatar for SatAI.challenge satai
3
290
言語モデルから言語について語る際に押さえておきたいこと
Avatar for Sho Yokoi eumesy
PRO
5
2.3k
YOLO26_ Key Architectural Enhancements and Performance Benchmarking for Real-Time Object Detection
Avatar for SatAI.challenge satai
3
800
重要だけど測れていないもの：高齢者ケアの見えない課題
Avatar for テオリア・テクノロジーズ theoriatec2024
0
330

Featured

See All Featured
The Pragmatic Product Professional
Avatar for Laura Van Doore lauravandoore
37
7.3k
Avoiding the “Bad Training, Faster” Trap in the Age of AI
Avatar for Mike Taylor tmiket
0
170
Six Lessons from altMBA
Avatar for Skipper Chong Warson skipperchong
29
4.3k
Why You Should Never Use an ORM
Avatar for John Nunemaker jnunemaker
PRO
61
9.9k
How to make the Groovebox
Avatar for あそなす asonas
2
2.2k
Unsuck your backbone
Avatar for Amy Palamountain ammeep
672
58k
SERP Conf. Vienna - Web Accessibility: Optimizing for Inclusivity and SEO
Avatar for Sara Fernández Carmona sarafernandez
2
1.5k
Understanding Cognitive Biases in Performance Measurement
Avatar for Philip Tellis bluesmoon
32
2.9k
Speed Design
Avatar for Sergey Chernyshev sergeychernyshev
33
1.8k
Writing Fast Ruby
Avatar for Erik Berlin sferik
630
63k
Thoughts on Productivity
Avatar for Jon Yablonski jonyablonski
76
5.2k
Testing 201, or: Great Expectations
Avatar for Joseph Mastey jmmastey
46
8.2k

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]