• Partagez
  • E-mail
  • Intégrer
  • J'aime
  • Télécharger
  • Contenu privé
Ten Reasons Developers Hate Your API
 

Ten Reasons Developers Hate Your API

on

  • 44,621 vues

APIs are everywhere today and can be a great building block of modern applications. But all too often APIs are not truly great. Rather than love your API, developers curse it. How can you avoid that ...

APIs are everywhere today and can be a great building block of modern applications. But all too often APIs are not truly great. Rather than love your API, developers curse it. How can you avoid that fate? In this session we'll look at the most common mistakes API providers make and you can avoid making them too. Do you offer a bad developer experience (DX)? Poor, inconsistent API design? Unreliable services? This talk is a deep dive on not just what to avoid but what to do instead. And you'll leave knowing how to get developers to love your API, not hate it. 

Statistiques

Vues

Total des vues
44,621
Vues sur SlideShare
41,506
Vues externes
3,115

Actions

J'aime
156
Téléchargements
644
Commentaires
10

26 Ajouts 3,115

http://www.programmableweb.com 1811
http://www.scoop.it 657
https://twitter.com 397
https://www.linkedin.com 72
http://blog.programmableweb.com 35
http://jooyoungyu.wordpress.com 31
http://www.linkedin.com 18
http://pw 17
http://mangastorytelling.tistory.com 16
http://www.google.com 15
http://www.schoox.com 12
http://plus.url.google.com 8
http://tweetedtimes.com 6
http://t.co 4
https://jooyoungyu.wordpress.com 3
http://programmableweb.com 2
http://lnkd.in 2
http://lnkd.in&_=1405154951908 HTTP 1
http://idratherbewriting.com 1
http://ams.activemailservice.com 1
https://mail.google.com 1
http://www.google.co.in 1
http://www.hanrss.com 1
http://zutaten.nl 1
https://tweetdeck.twitter.com 1
http://news.google.com 1
Plus...

Accessibilité

Détails de l'import

Uploaded via as Adobe PDF

Droits d'utilisation

© Tous droits réservés

Report content

Signalé comme inapproprié Signaler comme inapproprié
Signaler comme inapproprié

Indiquez la raison pour laquelle vous avez signalé cette présentation comme n'étant pas appropriée.

Annuler

110 sur 10 précédent suivant Publier un commentaire

  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Votre message apparaîtra ici
    Processing...
  • I have to second your use of Stripe's excellent example in this area. They are also *very* responsive to questions even from small shops.
    PayPal is abysmal in general dev user experience; I can't even imaging what Facebook must be like if they outranked PayPal in the Bad Rankings. ;)
    Are you sure you want to
    Votre message apparaîtra ici
    Processing...
  • pretty informative
    Are you sure you want to
    Votre message apparaîtra ici
    Processing...
  • very useful!!
    Are you sure you want to
    Votre message apparaîtra ici
    Processing...
  • Very useful information. Thanks for sharing this presentation.
    Are you sure you want to
    Votre message apparaîtra ici
    Processing...
  • I loved these slides. Thanks so much for sharing. There's a wealth of great advice here.
    Are you sure you want to
    Votre message apparaîtra ici
    Processing...
Poster un commentaire
Modifier votre commentaire

    Ten Reasons Developers Hate Your API Ten Reasons Developers Hate Your API Presentation Transcript

    • 10ReasonsDevelopers HateYourAPI (andwhattodoaboutit) John  Musser  @johnmusser    /    API  Science  @apiscience   GlueCon,  2014  
    • (private  beta)  
    • Your documentation sucks REASON #1
    • ISSUES Static Unloved Nogettingstarted Inaccurate Unprofessional Incomplete Outofdate
    • Bigpicture https://www.twilio.com/docs! FIX #1
    • Clarity https://stripe.com/docs/api! FIX #2
    • Find-ability https://stripe.com/docs/! FIX #3
    • LiveDocsFIX #4 Interactivedocumentation, like...
    • Swagger https://github.com/wordnik/swagger-core!
    • I/ODocs https://github.com/mashery/iodocs!
    • RAML RESTful API Modeling Language! raml.org!
    • Yourcommunication skillsneedwork REASON #2
    • Youdon’tkeep yourdevelopers informed REASON #2B
    • ISSUES WheredoIgetsupportagain? Toomany/fewchannels Infrequentcommunication Youbrokemycodewithoutwarning
    • ChangeLog http://developer.github.com/changes/! FIX #1
    • Roadmap https://developers.facebook.com/roadmap/! FIX #2
    • ReleaseNotes http://techblog.constantcontact.com/api/release-updates! FIX #3
    • Blog http://aws.typepad.com/! FIX #4
    • Forum http://stackoverflow.com/questions/tagged/soundcloud! FIX #5
    • EmailFIX #6
    • Youdon’t makeiteasy REASON #3
    • ISSUES HowdoIgetmykeys? Nogettingstartedguide NoSDKs/samplesinmylanguage Nothingtocopy&paste… No“helloworld”
    • Whatdoyoudo? https://www.twilio.com/voice/api! FIX #1
    • Fastsignup https://manage.stripe.com/register! FIX #2 (so fast, you can even skip this step till you’re convinced…)
    • The1-2-3 http://developer.constantcontact.com/get-started.html! FIX #3
    • Quickstarts https://www.twilio.com/docs/quickstart! FIX #4
    • Free&Trial https://parse.com/plans! FIX #5
    • CopiousSDKsFIX #6
    • UseGitHub https://github.com/OneNoteDev! FIX #7
    • Lawyers REASON #4
    • ISSUES Commercialrestrictions Notsetupforwin-win NoSLA Ratelimit/throttlingissues It’sallaboutyou
    • BeclearFIX #1 http://500px.com/terms!
    • SetthetoneFIX #2 https://www.etsy.com/developers/terms-of-use!
    • Shorter=BetterFIX #3 http://googledevelopers.blogspot.com! “Beginning  today,  most  of  our  APIs  use  a  single  Terms  of   Service.  We  have  rewri%en  these  terms  from  the  ground   up  with  the  goals  of  making  them  concise  and  easier  to   understand.     ….   In  this  rewrite,  we  have  removed  over  125,000  words   from  the  combined  previous  terms   …”  
    • Page  23  
    • ThinklongtermFIX #4 https://developers.google.com/youtube/terms!
    • Sharethewealth http://slideshare.net/jmusser! FIX #5
    • YourAPIis unreliable REASON #5
    • YourAPIis slow,buggyand unreliable REASON #5
    • ISSUES Bugs Unannouncedchanges Performanceissues APIoutages Inconsistency
    • Change (planned) BugOutage APIs can break Rate limit ToS violation Change (undocumented) Provider biz change Network
    • Breaking bad
    • Don’t let this happen to you GET http://api.yourcompany.com/resource/142! !
    • Or this… GET http://api.yourcompany.com/resource/142! !
    • StatusPage http://status.aws.amazon.com/! FIX #1
    • MonitorFIX #2 http://www.apiscience.com!
    • Don’thide http://blog.akismet.com! FIX #3
    • Youdon’tgiveme thetoolstohelp mesucceed REASON #6
    • ISSUES Testconsole? OAuth,ouch HowdoIdebug? What’smyusage?Spend?
    • DevDashboard https://manage.stripe.com/test/dashboard! FIX #1
    • Debug/Log www.twilio.com/user/account/developer-tools/app-monitor! FIX #2
    • TestSandbox https://www.twilio.com/user/account! FIX #3
    • Playground https://developers.google.com/oauthplayground! FIX #4
    • TestConsole https://apigee.com/providers! FIX #5
    • You’remarketing tome, nothelpingme REASON #7
    • ISSUES Youdon’tlisten Code,notwhitepapers Developershatemarketing Self-service,not“callus”
    • Evangelists http://sendgrid.com/developers! FIX #1
    • EventsFIX #2 https://www.twilio.com/conference!
    • HackathonsFIX #3
    • YourAPIistoo complex REASON #8
    • Youhaveyourown customs (auth,protocol,formats) REASON #8B
    • ISSUES Terse,crypticerrormessages NoJSONsupport Your“REST”APIdoesn’tuseHTTPrules YoustilluseSOAP
    • UseRESTFIX #1 API protocols and styles Based on directory of 5,100 web APIs listed at ProgrammableWeb, February 2012
    • UseJSONFIX #2 Percentage of APIs supporting JSON vs XML Based on directory 11,000 web APIs listed at ProgrammableWeb, Dec 2013
    • XML vs. JSON in new APIs Based on new APIs listed at ProgrammableWeb in 2013
    • BepragmaticFIX #3 http://apigee.com/about/content/web-api-design! Web API Design, Brian Mulloy
    • YourTTFHW istoolong REASON #9
    • What’s your TTFHW? Time To First “Hello World” aka: how long from zero to 60?
    • GreatDXFIX #1 http://developerexperience.org!
    • FIX #2 Allprior “fixes” inthistalk:-)
    • Youhaven’t learned REASON #10
    • Youhaven’t learned (fromthebest) REASON #10
    • UserolemodelsFIX #1 Twilio,Stripe,Github, SendGrid
    • KeeplearningFIX #2 apidays.io  apistrategyconference.com   www.gluecon.com   apicon.programmableweb.com  iloveapis2013.com   apiconference.com  
    • FIX #3 Remember: An API is a journey, not a destination
    • Thank You QuesMons,  ideas,  comments? john@apiscience.com   @johnmusser    
    • Photo  credits   Race  car:  hQp://www.flickr.com/photos/lim_lik_wei/3270522646/   Winding  road:  hQp://www.flickr.com/photos/maQhewthecoolguy/7518274258/