Upgrade to Pro — share decks privately, control downloads, hide ads and more …
Sign up for free

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
分析AIエージェントを育てる、動く環境を育てる
Avatar for Codatum codatum
1
990
事業活動を AI Ready にする攻めと守りのデータエンジニアリング / data-engineering-for-ai-ready-business
Avatar for pei0804 pei0804
7
2.6k
AgentCoreで実践するハーネスエンジニアリング
Avatar for やくも yakumo
1
300
「事実」を「計測」して、「解釈」する 〜AWS Lambdaのメモリ最適解の見つけ方〜
Avatar for maimyyym maimyyym
0
140
FOSS4Gを活用した自治体業務DXの試み
Avatar for keikatsu 470715
0
150
おそらく日本で唯一のDevRelインターン生として
Avatar for husensan husengs7
0
170
DevelopersIO 2026 知識の地図を描く ─ オントロジーとは何か？
Avatar for Satoru Ishikawa ishikawa_satoru
1
1.5k
「Docker Desktop不要の時代」は 来たのか？
Avatar for ueponx ueponx
0
540
AI時代だからこそ推したい！Gitコマンド再入門
Avatar for ムナカタ munakata
0
180
WasmをRustにする
Avatar for SansanTech sansantech
PRO
0
170
AI時代のPRレビューにどう向き合うか？
Avatar for KairiM kairim0
1
200
脆弱性診断って、何をしているの？ 〜弱点を見つけて、会社の改善につなげるまで〜
Avatar for KeeG keeg
0
870

Featured

See All Featured
Into the Great Unknown - MozCon
Avatar for Noah Learner thekraken
41
2.8k
The Art of Programming - Codeland 2020
Avatar for Erika Heidi erikaheidi
57
14k
Building Applications with DynamoDB
Avatar for Matt Wood mza
96
7.2k
Statistics for Hackers
Avatar for Jake VanderPlas jakevdp
799
230k
How to make the Groovebox
Avatar for あそなす asonas
2
2.5k
Designing Experiences People Love
Avatar for Jonathan Moore moore
143
24k
Tips & Tricks on How to Get Your First Job In Tech
Avatar for Honza Javorek honzajavorek
1
790
SEO for Brand Visibility & Recognition
Avatar for Aleyda Solis aleyda
0
4.8k
Bioeconomy Workshop: Dr. Julius Ecuru, Opportunities for a Bioeconomy in West Africa
Avatar for AKADEMIYA2063 akademiya2063
PRO
1
400
Design of three-dimensional binary manipulators for pick-and-place task avoiding obstacles (IECON2024)
Avatar for konakalab konakalab
0
610
SEO in 2025: How to Prepare for the Future of Search
Avatar for Michael King ipullrank
3
3.9k
Agile that works and the tools we love
Avatar for Rasmus Luckow-Nielsen rasmusluckow
331
22k

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