SlideShare is now on Android. 15 million presentations at your fingertips.  Get the app

×
  • Share
  • Email
  • Embed
  • Like
  • Save
  • Private Content
 

What Makes a Great Open API?

by on Jul 19, 2012

  • 49,995 views

What is it that turns an ordinary API into a great API? This talk from OSCON 2012 outlines the 5 "keys" to having a great API. Lots of examples from successful real-world APIs are used to highlight ...

What is it that turns an ordinary API into a great API? This talk from OSCON 2012 outlines the 5 "keys" to having a great API. Lots of examples from successful real-world APIs are used to highlight what matters. Also, this talk reveals 7 lesser known but very important "API secrets".

Statistics

Views

Total Views
49,995
Views on SlideShare
25,440
Embed Views
24,555

Actions

Likes
154
Downloads
962
Comments
7

116 Embeds 24,555

http://blog.programmableweb.com 19601
http://restfulapi.blogspot.com 1274
https://twitter.com 443
http://emsooriyabandara.blogspot.com 297
http://extensionengine.com 251
http://clasense4.wordpress.com 247
http://restfulapi.blogspot.in 196
http://cloudburo.github.io 192
http://restfulapi.blogspot.co.uk 159
http://restfulapi.blogspot.de 155
http://restfulapi.blogspot.nl 124
http://restfulapi.blogspot.fr 102
http://restfulapi.blogspot.com.br 101
http://restfulapi.blogspot.ca 97
http://manfredbo.tumblr.com 62
http://restfulapi.blogspot.com.es 61
http://restfulapi.blogspot.com.au 61
http://webicode.wordpress.com 58
http://onebv.com 54
http://restfulapi.blogspot.se 52
https://si0.twimg.com 50
http://restfulapi.blogspot.be 42
http://us-w1.rockmelt.com 42
http://restfulapi.blogspot.ro 37
http://restfulapi.blogspot.it 35
http://restfulapi.blogspot.mx 34
http://indykish.wordpress.com 33
http://www.twylah.com 31
http://restfulapi.blogspot.com.ar 29
http://restfulapi.blogspot.pt 26
http://restfulapi.blogspot.cz 23
http://restfulapi.blogspot.ru 23
http://restfulapi.blogspot.no 23
http://restfulapi.blogspot.sg 22
http://restfulapi.blogspot.co.at 22
http://lanyrd.com 22
http://restfulapi.blogspot.kr 20
http://restfulapi.blogspot.ie 20
http://www.scoop.it 20
http://restfulapi.blogspot.fi 20
http://localhost 20
http://restfulapi.blogspot.hk 18
http://restfulapi.blogspot.jp 18
http://restfulapi.blogspot.dk 18
http://restfulapi.blogspot.tw 17
http://restfulapi.blogspot.gr 16
http://disp.cc 16
http://checchia.net 14
http://emsooriyabandara.blogspot.ca 14
http://wiki.bcmoney-mobiletv.com 14
More...

Accessibility

Categories

Upload Details

Uploaded via SlideShare as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel

17 of 7 previous next Post a comment

  • asaveliev Artem Saveliev, Sr E-Commerce Architect at Hertz video presentation from qcon 2013 that follows this deck
    http://www.infoq.com/presentations/api-design-advice
    2 months ago
    Are you sure you want to
    Your message goes here
    Processing…
  • 3scale 3SCALE at 3SCALE Awesome slide set - we wrote a series of blog posts trying to drill down on each of these topics: http://www.3scale.net/2012/11/building-great-apis-the-api-gold-standard-part-i/ (about to wrap up with the final post!). 1 year ago
    Are you sure you want to
    Your message goes here
    Processing…
  • rajeshsingamsetty Rajesh Singamsetty, Founder, CEO at ITW (Insttitute of Technical Writing) Awesome 1 year ago
    Are you sure you want to
    Your message goes here
    Processing…
  • mazurekit Pawel Mazurek, CMO at iTraff Technology @johnmusser Thank you for great tips! It's really helpfull as we still working on our image recognition api recognize.im
    It's really helpfull!
    1 year ago
    Are you sure you want to
    Your message goes here
    Processing…
  • jpmalek Jeff Malek @jmusser makes sense, thanks a ton for the great work. Awesome deck. 1 year ago
    Are you sure you want to
    Your message goes here
    Processing…
  • jmusser jmusser @jpmalek It's true that if it's possible for an organization to follow your approach then what you suggest could be preferable (somewhat akin to what Daniel Jacobson from Netflix recommends). But, in many or most cases this may not be feasible, in particular not only for technical reasons, but also business reasons since so much can change down the line (ex: business strategy change driving a substantial API change), and if you haven't set the stage for versioning then it can be hard to retrofit (not to mention then lead to unhappy developers because you've changed the rules later). 1 year ago
    Are you sure you want to
    Your message goes here
    Processing…
  • jpmalek Jeff Malek John, wrt slide 54 and making sure to version your API: we make our API revisions reverse-compatible, and only roll forward, testing thoroughly for regressions, integrity and compatibility. I'd assume that's an even more preferred approach, but curious to hear your take - any thoughts? 1 year ago
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

What Makes a Great Open API? What Makes a Great Open API? Presentation Transcript