• Email
  • Like
  • Save
  • Private Content
  • Embed
 

What Makes a Great Open API?

by on Jul 19, 2012

  • 35,515 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

92 Embeds 18,676

http://blog.programmableweb.com 17120
http://emsooriyabandara.blogspot.com 254
http://clasense4.wordpress.com 219
http://restfulapi.blogspot.com 160
https://twitter.com 159
http://extensionengine.com 159
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 27
http://restfulapi.blogspot.co.uk 26
http://lanyrd.com 18
http://restfulapi.blogspot.ca 17
http://disp.cc 16
http://www.scoop.it 15
http://indykish.wordpress.com 15
http://checchia.net 14
http://restfulapi.blogspot.kr 13
http://restfulapi.blogspot.de 13
http://restfulapi.blogspot.com.br 13
http://emsooriyabandara.blogspot.ca 12
https://twimg0-a.akamaihd.net 12
http://restfulapi.blogspot.nl 11
http://feeds2.feedburner.com 11
http://restfulapi.blogspot.se 9
http://restfulapi.blogspot.fr 8
http://blog.pheromonic.com 7
http://emsooriyabandara.blogspot.com.es 6
http://emsooriyabandara.blogspot.co.uk 6
http://localhost 6
http://pinterest.com 6
http://dev.newsblur.com 6
http://emsooriyabandara.blogspot.in 6
http://restfulapi.blogspot.ie 5
http://restfulapi.blogspot.com.es 5
http://restfulapi.blogspot.com.au 5
http://www.mashup.or.kr 5
http://wiki.bcmoney-mobiletv.com 5
http://www.linkedin.com 5
http://www.hanrss.com 4
http://restfulapi.blogspot.pt 4
http://clipboard.com 4
http://www.bonweb.fr 4
http://restfulapi.blogspot.be 4
http://restfulapi.blogspot.ru 4
http://restfulapi.blogspot.dk 3
http://restfulapi.blogspot.ro 3
http://restfulapi.blogspot.no 3
http://restfulapi.blogspot.ch 3
http://mashup.hosting.paran.com 3

More...

Statistics

Likes
131
Downloads
684
Comments
6
Embed Views
18,676
Views on SlideShare
16,839
Total Views
35,515

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. 10 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). 10 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