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

API Design Lifecycle

Sponsored · Ship Features Fearlessly Turn features on and off without deploys. Used by thousands of Ruby developers. →
Avatar for Mark W. Foster Mark W. Foster
May 30, 2015
Technology
130
0

API Design Lifecycle

Collaborating to Build Great APIs

Avatar for Mark W. Foster

Mark W. Foster

May 30, 2015

More Decks by Mark W. Foster

See All by Mark W. Foster
Client-Driven APIs
Avatar for Mark W. Foster fosrias
0
200
Use and Re-use of API Description Languages in the Design Lifecycle
Avatar for Mark W. Foster fosrias
0
290

Other Decks in Technology

See All in Technology
制約理論（ToC）入門　2026版
Avatar for Recruit recruitengineers
PRO
8
2.5k
Model Studio CLI × Token Plan
Avatar for 尾関将樹 | めい maigo999
0
190
事業価値と Engineering 2026年度版
Avatar for Recruit recruitengineers
PRO
51
25k
ブラウザ研修 2026
Avatar for Recruit recruitengineers
PRO
6
1.1k
LanceDB入門
Avatar for Tomoko Uchida mocobeta
8
590
会社紹介資料 / Sansan Company Profile
Avatar for Sansan, Inc. sansan33
PRO
24
430k
20260804_Q4AzureUpdateBite_FabricDataAgentの精度を高める設計.pdf
Avatar for matayuuu matayuuu
1
140
35分でわかるEffective Platform Engineering
Avatar for nwiizo nwiizo
3
290
MulticaとPi Coding Agentで、小規模OSSを30本同時運用した流れ
Avatar for eiei114 eiei114
0
130
自宅NWにISR4331を導入してみた話
Avatar for okaits#7534 okaits
0
110
My broken English still works: speaking at global OSS events
Avatar for Naruhiko Ogasawara naruoga
0
110
なぜ Temporal の大小比較には compare しかないのか / Why Does Temporal Only Have compare() for Comparisons
Avatar for KazukiHayase kazukihayase
1
150

Featured

See All Featured
JavaScript: Past, Present, and Future - NDC Porto 2020
Avatar for David Neal reverentgeek
52
6k
Fantastic passwords and where to find them - at NoRuKo
Avatar for Phil Nash philnash
52
3.8k
A brief & incomplete history of 
UX Design for the World Wide Web: 1989–2019
Avatar for Jason CranfordTeague jct
2
470
Improving Core Web Vitals using Speculation Rules API
Avatar for Sergey Chernyshev sergeychernyshev
21
1.6k
Claude Code のすすめ
Avatar for schroneko schroneko
67
230k
We Have a Design System, Now What?
Avatar for Morgane Peng morganepeng
55
8.3k
Designing for Performance
Avatar for Lara Hogan lara
611
70k
AI Search:
Where Are We & What Can We Do About It?
Avatar for Aleyda Solis aleyda
0
7.8k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
Avatar for Irina Nazarova irinanazarova
9
1.5k
Skip the Path - Find Your Career Trail
Avatar for Mark Kilby mkilby
1
190
GitHub's CSS Performance
Avatar for Jon Rohan jonrohan
1033
470k
The Cost Of JavaScript in 2023
Avatar for Addy Osmani addyosmani
55
10k

Transcript

  1. API Design Lifecycle Collaborating to Build Great APIs

  2. – Leslie Lamport “I believe that the best way to

    get better programs is to teach programmers how to think better.”

  3. Architecture is related to a set of (self- imposed) constraints

    that produce a set of favorable properties of a system

  4. Design First • Include variety of stakeholders • Top-down vs.

    bottom-up • Develop good designs early • Re-usable description format as contract • Write less code

  5. The best design of an API is not a particular

    paradigm or architecture – it is a design where everybody at the table agreed on what the API is/will be.

  6. Prototyping • Collaborative • Realtime mocking • Code Generation

  7. Implementation • Parallel Client/Server Development • TDD/BDD/CI Integration

  8. Documentation • Auto-generated • Interactive • Validated in CI

  9. Monitoring • Post-deployment Smoke Testing • Debugging • Inspection

  10. Mark W. Foster [email protected] @fosrias @apiaryio We’re Hiring! http://docs.pollsdemoapi.apiary.io