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
120

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
DevIO2025_継続的なサービス開発のための技術的意思決定のポイント / how-to-tech-decision-makaing-devio2025
Avatar for Logy nologyance
1
400
AI時代を生き抜くエンジニアキャリアの築き方 (AI-Native 時代、エンジニアという道は 「最大の挑戦の場」となる) / Building an Engineering Career to Thrive in the Age of AI (In the AI-Native Era, the Path of Engineering Becomes the Ultimate Arena of Challenge)
Avatar for JaeSoon Jeong jeongjaesoon
0
140
💡Ruby 川辺で灯すPicoRubyからの光
Avatar for bash0C7 bash0c7
0
120
COVESA VSSによる車両データモデルの標準化とAWS IoT FleetWiseの活用
Avatar for Yuto Osawa osawa
1
290
共有と分離 - Compose Multiplatform "本番導入" の設計指針
Avatar for Ryo WATANABE error96num
2
570
Generative AI Japan 第一回生成AI実践研究会「AI駆動開発の現在地──ブレイクスルーの鍵を握るのはデータ領域」
Avatar for KoheiOgawa shisyu_gaku
0
270
ブロックテーマ時代における、テーマの CSS について考える Toro_Unit / 2025.09.13 @ Shinshu WordPress Meetup
Avatar for Toro_Unit (Hiroshi Urabe) torounit
0
130
Webブラウザ向け動画配信プレイヤーの 大規模リプレイスから得た知見と学び
Avatar for yud0uhu yud0uhu
0
230
Webアプリケーションにオブザーバビリティを実装するRust入門ガイド
Avatar for nwiizo nwiizo
7
830
Aurora DSQLはサーバーレスアーキテクチャの常識を変えるのか
Avatar for TomoyaIwata iwatatomoya
1
990
Language Update: Java
Avatar for Yuichi.Sakuraba skrb
2
300
要件定義・デザインフェーズでもAIを活用して、コミュニケーションの密度を高める
Avatar for KazukiHayase kazukihayase
0
110

Featured

See All Featured
How to train your dragon (web standard)
Avatar for Monica Dinculescu notwaldorf
96
6.2k
The Invisible Side of Design
Avatar for Vitaly Friedman smashingmag
301
51k
No one is an island. Learnings from fostering a developers community.
Avatar for Antonio thoeni
21
3.4k
Raft: Consensus for Rubyists
Avatar for Patrick Van Stee vanstee
140
7.1k
GitHub's CSS Performance
Avatar for Jon Rohan jonrohan
1032
460k
Dealing with People You Can't Stand - Big Design 2015
Avatar for Cassini Nazir cassininazir
367
27k
Optimizing for Happiness
Avatar for Tom Preston-Werner mojombo
379
70k
Optimising Largest Contentful Paint
Avatar for Harry Roberts csswizardry
37
3.4k
Build your cross-platform service in a week with App Engine
Avatar for Jose L jlugia
231
18k
For a Future-Friendly Web
Avatar for Brad Frost brad_frost
180
9.9k
[RailsConf 2023 Opening Keynote] The Magic of Rails
Avatar for Eileen M. Uchitelle eileencodes
30
9.7k
Building a Scalable Design System with Sketch
Avatar for Laura Van Doore lauravandoore
462
33k

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