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

API Design Lifecycle

Avatar for Mark W. Foster Mark W. Foster
May 30, 2015
Technology
0
130

API Design Lifecycle

Collaborating to Build Great APIs

Avatar for Mark W. Foster

Mark W. Foster

May 30, 2015
Tweet

More Decks by Mark W. Foster

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

Other Decks in Technology

See All in Technology
データ戦略部門 紹介資料
Avatar for Sansan, Inc. sansan33
PRO
1
3.7k
綺麗なデータマートをつくろう_データ整備を前向きに考える会 / Let's create clean data mart
Avatar for BrainPad brainpadpr
3
520
エンタメとAIのための3Dパラレルワールド構築（GPU UNITE 2025 特別講演）
Avatar for Preferred Networks pfn
PRO
0
320
All About Sansan – for New Global Engineers
Avatar for Sansan, Inc. sansan33
PRO
1
1.2k
[Keynote] What do you need to know about DevEx in 2025
Avatar for Salaboy salaboy
0
170
【Kaigi on Rails 事後勉強会LT】MeはどうしてGirlsに？ 私とRubyを繋いだRail(s)
Avatar for joy joyfrommasara
0
260
プレーリーカードを活用しよう❗❗デジタル名刺交換からはじまるイベント会場交流のススメ
Avatar for Masataka Tsukamoto tsukaman
0
160
Digitization部 紹介資料
Avatar for Sansan, Inc. sansan33
PRO
1
5.5k
そのWAFのブロック、どう活かす？ サービスを守るための実践的多層防御と思考法 / WAF blocks defense decision
Avatar for 株式会社カミナシ kaminashi
0
200
Sansan Engineering Unit 紹介資料
Avatar for Sansan, Inc. sansan33
PRO
1
3k
Adminaで実現するISMS/SOC2運用の効率化 〜 アカウント管理編 〜
Avatar for shonansurvivors shonansurvivors
4
450
能登半島地震で見えた災害対応の課題と組織変革の重要性
Avatar for Masakatsu Sugii ditccsugii
0
930

Featured

See All Featured
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
Avatar for Eileen M. Uchitelle eileencodes
140
34k
The Illustrated Children's Guide to Kubernetes
Avatar for Chris Short chrisshort
49
51k
Intergalactic Javascript Robots from Outer Space
Avatar for Vicent Martí tanoku
273
27k
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
Avatar for Michelle Schulp Hunt marktimemedia
31
2.5k
Stop Working from a Prison Cell
Avatar for Chris Michel hatefulcrawdad
271
21k
Agile that works and the tools we love
Avatar for Rasmus Luckow-Nielsen rasmusluckow
331
21k
Rails Girls Zürich Keynote
Avatar for Gregor Martynus gr2m
95
14k
Imperfection Machines: The Place of Print at Facebook
Avatar for Scott Boms scottboms
269
13k
4 Signs Your Business is Dying
Avatar for Josh Pigford shpigford
185
22k
Why Our Code Smells
Avatar for Brandon Keepers bkeepers
PRO
340
57k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
Avatar for Marc Duiker marcduiker
33
2.3k
Building Flexible Design Systems
Avatar for Yesenia Perez-Cruz yeseniaperezcruz
329
39k

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