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
Kiroと学ぶコンテキストエンジニアリング
Avatar for Oikon oikon48
6
8.5k
Kubernetes における cgroup driver のしくみ: runwasi の bugfix より
Avatar for z63d z63d
2
130
落ちる 落ちるよ サーバーは落ちる
Avatar for 末廣雅利 suehiromasatoshi
0
130
DevIO2025_継続的なサービス開発のための技術的意思決定のポイント / how-to-tech-decision-makaing-devio2025
Avatar for Logy nologyance
0
150
iPhone Eye Tracking機能から学ぶやさしいアクセシビリティ
Avatar for Kaito Fujimura fujiyamaorange
0
580
新規案件の立ち上げ専門チームから見たAI駆動開発の始め方
Avatar for ShuyaKinjo shuyakinjo
0
680
自作JSエンジンに推しプロポーザルを実装したい！
Avatar for Saji sajikix
1
140
250905 大吉祥寺.pm 2025 前夜祭 「プログラミングに出会って20年、『今』が1番楽しい」
Avatar for Masaya Kudo msykd
PRO
1
370
「魔法少女まどか☆マギカ Magia Exedra」の必殺技演出を徹底解剖！ -キャラクターの魅力を最大限にファンに届けるためのこだわり-
Avatar for gree_tech gree_tech
PRO
0
520
エラーとアクセシビリティ
Avatar for Tajima Sachiko schktjm
0
870
【 LLMエンジニアがヒューマノイド開発に挑んでみた 】 - 第104回 Machine Learning 15minutes! Hybrid
Avatar for soneo1127 soneo1127
0
280
絶対に失敗できないキャンペーンページの高速かつ安全な開発、WINTICKET × microCMS の開発事例
Avatar for microCMS microcms
0
390

Featured

See All Featured
Build your cross-platform service in a week with App Engine
Avatar for Jose L jlugia
231
18k
Practical Tips for Bootstrapping Information Extraction Pipelines
Avatar for Matthew Honnibal honnibal
PRO
23
1.4k
The World Runs on Bad Software
Avatar for Brandon Keepers bkeepers
PRO
70
11k
Six Lessons from altMBA
Avatar for Skipper Chong Warson skipperchong
28
4k
Thoughts on Productivity
Avatar for Jon Yablonski jonyablonski
69
4.8k
Site-Speed That Sticks
Avatar for Harry Roberts csswizardry
10
810
実際に使うSQLの書き方 徹底解説 / pgcon21j-tutorial
Avatar for soudai sone soudai
PRO
185
54k
Building an army of robots
Avatar for Kyle Neath kneath
306
46k
BBQ
Avatar for Matthew Crist matthewcrist
89
9.8k
Making the Leap to Tech Lead
Avatar for Ryan Cromwell cromwellryan
134
9.5k
Being A Developer After 40
Avatar for Adrian Kosmaczewski akosma
90
590k
ReactJS: Keep Simple. Everything can be a component!
Avatar for Pedro Nauck pedronauck
667
120k

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