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

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
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
190
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
(Test) ai-meetup slide creation
Avatar for Oikon oikon48
2
330
8万デプロイ
Avatar for iwamot iwamot
PRO
2
230
Shifting from MCP to Skills / ベストプラクティスの変遷を辿る
Avatar for Okuto Oyama yamanoku
4
830
オレ達はAWS管理をやりたいんじゃない！開発の生産性を爆アゲしたいんだ！！
Avatar for wkm2 wkm2
4
510
銀行の​内製開発にて​2つの​プロダクトを​１つのチームで​スクラムしてみてる​話
Avatar for koba1210 koba1210
1
120
OCI Security サービス 概要
Avatar for oracle4engineer oracle4engineer
PRO
2
13k
新職業『オーケストレーター』誕生 — エージェント10体を同時に回すAgentOps
Avatar for Gunther Brunner gunta
4
1.8k
マルチプレーンGPUネットワークを実現するシャッフルアーキテクチャの整理と考察
Avatar for Masayuki Kobayashi markunet
2
240
脳内メモリ、思ったより揮発性だった
Avatar for koutorino koutorino
0
310
OSC仙台プレ勉強会　AlmaLinuxとは
Avatar for koedoyoshida koedoyoshida
0
150
元エンジニアPdM、IDEが恋しすぎてCursorに全業務を集約したら、スライド作成まで爆速になった話
Avatar for "doiko" chiaki_yamaguchi doiko123
1
610
Oracle Database@AWS：サービス概要のご紹介
Avatar for oracle4engineer oracle4engineer
PRO
3
1.7k

Featured

See All Featured
Producing Creativity
Avatar for Steve Smith orderedlist
PRO
348
40k
What’s in a name? Adding method to the madness
Avatar for The Alliance productmarketing
PRO
24
4k
Practical Orchestrator
Avatar for Shlomi Noach shlominoach
191
11k
Beyond borders and beyond the search box: How to win the global "messy middle" with AI-driven SEO
Avatar for David Carrasco davidcarrasco
3
70
Visualizing Your Data: Incorporating Mongo into Loggly Infrastructure
Avatar for mongodb mongodb
49
9.9k
How to Build an AI Search Optimization Roadmap - Criteria and Steps to Take #SEOIRL
Avatar for Aleyda Solis aleyda
1
2k
Writing Fast Ruby
Avatar for Erik Berlin sferik
630
63k
How to build an LLM SEO readiness audit: a practical framework
Avatar for Nick Samuel nmsamuel
1
670
XXLCSS - How to scale CSS and keep your sanity
Avatar for Zaharenia Atzitzikaki sugarenia
249
1.3M
コードの90%をAIが書く世界で何が待っているのか / What awaits us in a world where 90% of the code is written by AI
Avatar for r-kagaya rkaga
60
42k
Embracing the Ebb and Flow
Avatar for Simon Collison colly
88
5k
Tell your own story through comics
Avatar for letsgokoyo letsgokoyo
1
840

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