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

Harmony in API Design

Avatar for API Strategy & Practice Conference API Strategy & Practice Conference
October 24, 2013
Technology
1
210

Harmony in API Design

By Jakub Nesetril @ API Strategy & Practice Conference
San Francisco, October 23-24-25, 2013

Avatar for API Strategy & Practice Conference

API Strategy & Practice Conference

October 24, 2013
Tweet

More Decks by API Strategy & Practice Conference

See All by API Strategy & Practice Conference
APIStrat 2016 | The end of polling: why and how to transform a REST API into a Data Streaming API (Audrey Neveu)
Avatar for API Strategy & Practice Conference apistrat
12
310
APIStrat 2016 | OpenAPI Trek: Beyond API Documentation (Arnaud Lauret)
Avatar for API Strategy & Practice Conference apistrat
5
240
APIStrat 2016 | Flying Dreams: Real-Time Communication from the Edge of Space (Jonathan Barton, Neha Abrol)
Avatar for API Strategy & Practice Conference apistrat
1
150
APIStrat 2016 | On-prem support? That was so 1982 (Charlie Ozinga)
Avatar for API Strategy & Practice Conference apistrat
0
130
APIStrat 2016 | Effortless microservices in production with Kubernetes (Ken Wronkiewicz)
Avatar for API Strategy & Practice Conference apistrat
0
180
Song by Tony Blank
Avatar for API Strategy & Practice Conference apistrat
0
200
API Lifecycle Manager by Steve Fonseca
Avatar for API Strategy & Practice Conference apistrat
2
260
APIs In The Enterprise: How Walgreens Formed It's Digital Business by Drew Schweinfurth
Avatar for API Strategy & Practice Conference apistrat
1
400
Developers Are Difficult by Andrew Noonan
Avatar for API Strategy & Practice Conference apistrat
0
140

Other Decks in Technology

See All in Technology
AIにより大幅に強化された AWS Transform Customを触ってみる
Avatar for arap / 0air 0air
0
190
ハーネスエンジニアリング×AI適応開発
Avatar for Ryohei Kamiya aictokamiya
1
780
Navigation APIと見るSvelteKitのWeb標準志向
Avatar for Okuto Oyama yamanoku
2
130
OCI技術資料 : 証明書サービス概要
Avatar for Oracle Cloud Infrastructure ソリューション・エンジニア ocise
1
7.1k
Network Firewall Proxyで 自前プロキシを消し去ることができるのか
Avatar for ぐっさん gusandayo
0
120
なぜarray_firstとarray_lastは採用、 array_value_firstとarray_value_lastは 見送りだったか / Why array_value_first and array_value_last was declined, then why array_first and array_last was accpeted?
Avatar for 02 cocoeyes02
0
290
JEDAI認定プログラム JEDAI Order 2026 受賞者一覧 / JEDAI Order 2026 Winners
Avatar for Databricks Japan databricksjapan
0
400
FlutterでPiP再生を実装した話
Avatar for 白井翔大 s9a17
0
230
Cursor Subagentsはいいぞ
Avatar for Yuji Yamaguchi yug1224
2
120
AI時代のシステム開発者の仕事_20260328
Avatar for 閃利㈱河村 純 sengtor
0
310
OCI技術資料 : ロード・バランサ 概要 - FLB・NLB共通
Avatar for Oracle Cloud Infrastructure ソリューション・エンジニア ocise
4
27k
Bill One 開発エンジニア 紹介資料
Avatar for Sansan, Inc. sansan33
PRO
5
18k

Featured

See All Featured
The untapped power of vector embeddings
Avatar for Frank van Dijk frankvandijk
2
1.6k
16th Malabo Montpellier Forum Presentation
Avatar for AKADEMIYA2063 akademiya2063
PRO
0
85
The World Runs on Bad Software
Avatar for Brandon Keepers bkeepers
PRO
72
12k
Learning to Love Humans: Emotional Interface Design
Avatar for Aarron Walter aarron
275
41k
Stop Working from a Prison Cell
Avatar for Chris Michel hatefulcrawdad
274
21k
Principles of Awesome APIs and How to Build Them.
Avatar for Keavy McMinn keavy
128
17k
Mind Mapping
Avatar for Hélio Medeiros helmedeiros
PRO
1
130
Fashionably flexible responsive web design (full day workshop)
Avatar for Andy Clarke malarkey
408
66k
Code Reviewing Like a Champion
Avatar for maltzj maltzj
528
40k
Automating Front-end Workflow
Avatar for Addy Osmani addyosmani
1370
200k
For a Future-Friendly Web
Avatar for Brad Frost brad_frost
183
10k
Pawsitive SEO: Lessons from My Dog (and Many Mistakes) on Thriving as a Consultant in the Age of AI
Avatar for David Carrasco davidcarrasco
0
94

Transcript

  1. Harmony in API Design [email protected]

  2. What is an API?

  3. None
  4. None

  5. API is UI to Data

  6. API is UI to Data

  7. API is UI to Data User Experience

  8. API is UI to Data User Experience Design

  9. API is UI to Data User Experience Design Emotions

  10. API is UI to Data User Experience Design Subjective Emotions

  11. API is UI to Data User Experience Design Subjective Emotions

    Culturally Dependent

  12. API is UI to Data User Experience Design Subjective Simplicity

    Emotions Culturally Dependent

  13. API is UI to Data User Experience Design Subjective Simplicity

    Emotions Productivity Culturally Dependent

  14. API is UI to Data User Experience Design Subjective Simplicity

    Conversion Rates Emotions Productivity Culturally Dependent

  15. API is UI to Data User Experience Design Subjective Simplicity

    Conversion Rates Emotions Productivity Usability Studies Culturally Dependent

  16. API is UI to Data User Experience Design Subjective Simplicity

    Conversion Rates Emotions Productivity Culturally Dependent Hackathons

  17. Nobody thinks THEIR design sucks

  18. None
  19. None

  20. Provider Consumer

  21. Provider Consumer Java Rails Scala Erlang

  22. Provider Consumer Java Rails Scala Erlang jQuery ObjC PHP

  23. Provider Consumer Uptime Caching Security Maintenance Versioning Validation Java Rails

    Scala Erlang jQuery ObjC PHP

  24. Provider Consumer Uptime Caching Security Maintenance Versioning Validation Can It

    Be Done? Debugging Support TTFHW Example Latency Java Rails Scala Erlang jQuery ObjC PHP

  25. So?

  26. 1. Start With a Wireframe •a design intent •usually an

    API description language •at Apiary we use API Blueprint

  27. 2. Involve Your Customers •find your early-adopters before you code

    •create an API mock that they can use •fork/pull-request

  28. 3. Have Great Documentation •generated automatically •must be exhaustive and

    up-to-date •your code is automatically tested; so must your documentation

  29. 4. Separate Contract from Implementation

  30. Summary •API is UI for Data & Interface between cultures

    •Involve your customers early •Automate

  31. @apiaryio http://apiary.io/ ! @jakubnesetril Thank You