Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
API Design Lifecycle
Search
Mark W. Foster
May 30, 2015
Technology
0
130
API Design Lifecycle
Collaborating to Build Great APIs
Mark W. Foster
May 30, 2015
Tweet
Share
More Decks by Mark W. Foster
See All by Mark W. Foster
Client-Driven APIs
fosrias
0
180
Use and Re-use of API Description Languages in the Design Lifecycle
fosrias
0
280
Other Decks in Technology
See All in Technology
データ戦略部門 紹介資料
sansan33
PRO
1
3.7k
綺麗なデータマートをつくろう_データ整備を前向きに考える会 / Let's create clean data mart
brainpadpr
3
520
エンタメとAIのための3Dパラレルワールド構築(GPU UNITE 2025 特別講演)
pfn
PRO
0
320
All About Sansan – for New Global Engineers
sansan33
PRO
1
1.2k
[Keynote] What do you need to know about DevEx in 2025
salaboy
0
170
【Kaigi on Rails 事後勉強会LT】MeはどうしてGirlsに? 私とRubyを繋いだRail(s)
joyfrommasara
0
260
プレーリーカードを活用しよう❗❗デジタル名刺交換からはじまるイベント会場交流のススメ
tsukaman
0
160
Digitization部 紹介資料
sansan33
PRO
1
5.5k
そのWAFのブロック、どう活かす? サービスを守るための実践的多層防御と思考法 / WAF blocks defense decision
kaminashi
0
200
Sansan Engineering Unit 紹介資料
sansan33
PRO
1
3k
Adminaで実現するISMS/SOC2運用の効率化 〜 アカウント管理編 〜
shonansurvivors
4
450
能登半島地震で見えた災害対応の課題と組織変革の重要性
ditccsugii
0
930
Featured
See All Featured
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
140
34k
The Illustrated Children's Guide to Kubernetes
chrisshort
49
51k
Intergalactic Javascript Robots from Outer Space
tanoku
273
27k
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
marktimemedia
31
2.5k
Stop Working from a Prison Cell
hatefulcrawdad
271
21k
Agile that works and the tools we love
rasmusluckow
331
21k
Rails Girls Zürich Keynote
gr2m
95
14k
Imperfection Machines: The Place of Print at Facebook
scottboms
269
13k
4 Signs Your Business is Dying
shpigford
185
22k
Why Our Code Smells
bkeepers
PRO
340
57k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
marcduiker
33
2.3k
Building Flexible Design Systems
yeseniaperezcruz
329
39k
Transcript
API Design Lifecycle Collaborating to Build Great APIs
– Leslie Lamport “I believe that the best way to
get better programs is to teach programmers how to think better.”
Architecture is related to a set of (self- imposed) constraints
that produce a set of favorable properties of a system
Design First • Include variety of stakeholders • Top-down vs.
bottom-up • Develop good designs early • Re-usable description format as contract • Write less code
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.
Prototyping • Collaborative • Realtime mocking • Code Generation
Implementation • Parallel Client/Server Development • TDD/BDD/CI Integration
Documentation • Auto-generated • Interactive • Validated in CI
Monitoring • Post-deployment Smoke Testing • Debugging • Inspection
Mark W. Foster
[email protected]
@fosrias @apiaryio We’re Hiring! http://docs.pollsdemoapi.apiary.io