• Email
  • Like
  • Save
  • Private Content
  • Embed
 

What Makes a Great Open API?

by on Jul 19, 2012

  • 35,303 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".

Accessibility

Categories

Upload Details

Uploaded via SlideShare as Adobe PDF

Usage Rights

© All Rights Reserved

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate. If needed, use the feedback form to let us know more details.

Cancel

91 Embeds 18,554

http://blog.programmableweb.com 17048
http://emsooriyabandara.blogspot.com 240
http://clasense4.wordpress.com 219
http://extensionengine.com 157
https://twitter.com 154
http://restfulapi.blogspot.com 148
http://webicode.wordpress.com 58
https://si0.twimg.com 50
http://us-w1.rockmelt.com 42
http://www.twylah.com 31
http://restfulapi.blogspot.in 25
http://restfulapi.blogspot.co.uk 24
http://lanyrd.com 18
http://restfulapi.blogspot.ca 17
http://disp.cc 16
http://indykish.wordpress.com 15
http://checchia.net 14
http://www.scoop.it 13
http://restfulapi.blogspot.kr 13
http://restfulapi.blogspot.de 13
http://emsooriyabandara.blogspot.ca 12
https://twimg0-a.akamaihd.net 12
http://feeds2.feedburner.com 11
http://restfulapi.blogspot.com.br 11
http://restfulapi.blogspot.nl 9
http://restfulapi.blogspot.fr 7
http://blog.pheromonic.com 7
http://localhost 6
http://emsooriyabandara.blogspot.com.es 6
http://restfulapi.blogspot.se 6
http://emsooriyabandara.blogspot.co.uk 6
http://dev.newsblur.com 6
http://emsooriyabandara.blogspot.in 6
http://pinterest.com 6
http://wiki.bcmoney-mobiletv.com 5
http://restfulapi.blogspot.ie 5
http://www.linkedin.com 5
http://restfulapi.blogspot.com.au 5
http://www.mashup.or.kr 5
http://restfulapi.blogspot.pt 4
http://www.hanrss.com 4
http://restfulapi.blogspot.com.es 4
http://www.bonweb.fr 4
http://clipboard.com 4
http://restfulapi.blogspot.ru 4
http://kred.com 3
http://emsooriyabandara.blogspot.de 3
http://restfulapi.blogspot.ch 3
http://restfulapi.blogspot.be 3
http://google.com 3
http://translate.googleusercontent.com 3

More...

Statistics

Likes
130
Downloads
679
Comments
6
Embed Views
18,554
Views on SlideShare
16,749
Total Views
35,303

16 of 6 previous next Post a comment

  • 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!). 3 months ago
    Are you sure you want to
  • rajeshsingamsetty Rajesh Singamsetty, Founder, CEO at ITW (Insttitute of Technical Writing) Awesome 4 months ago
    Are you sure you want to
  • 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! 6 months ago
    Are you sure you want to
  • jpmalek Jeff Malek @jmusser makes sense, thanks a ton for the great work. Awesome deck. 9 months ago
    Are you sure you want to
  • 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). 9 months ago
    Are you sure you want to
  • 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? 10 months ago
    Are you sure you want to
Post Comment
Edit your comment

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