Jesse Emery, Your Trove

1,055 views

Published on

NYC BAPI 2011 Speaker Presentation

Published in: Technology
0 Comments
1 Like
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
1,055
On SlideShare
0
From Embeds
0
Number of Embeds
8
Actions
Shares
0
Downloads
4
Comments
0
Likes
1
Embeds 0
No embeds

No notes for slide

Jesse Emery, Your Trove

  1. 1. Why Your API Sucks Business of APIs Conference, NY, 10/19/2011 An API developer survey opens Pandora’s Box http://bit.ly/trove-survey-results Jesse Emery, Co-Founder www.yourtrove.com j@yourtrove.com @ejesse #apisuck 10/19/2011 1Thursday, October 27, 2011
  2. 2. We did a survey on API Pain It made some waves You can view it here: http://bit.ly/trove-survey-results 10/19/2011 2Thursday, October 27, 2011
  3. 3. “Facebook Wins ‘Worst API’ in Developer Survey” - TechCrunch “Developers relate a tale of woe with Facebooks API” - The Inquirer “Developer survey finds Facebook has the worst API” - ZD Net 10/19/2011 3Thursday, October 27, 2011
  4. 4. Booooring It’s no real secret that Facebook’s API is widely loathed 10/19/2011 4Thursday, October 27, 2011
  5. 5. 10/19/2011 5Thursday, October 27, 2011
  6. 6. Developers Hate Your API “Every integration is its own [expletive-deleted] adventure.” 10/19/2011 6Thursday, October 27, 2011
  7. 7. APIs don’t live in a vacuum 10/19/2011 7Thursday, October 27, 2011
  8. 8. APIs don’t live in a vacuum 10/19/2011 8Thursday, October 27, 2011
  9. 9. “different idiosyncrasies, ie rate limiting, terms of service, data format, old documentation etc.” “REST vs. XML-RPC vs. SOAP, JSON vs. XML vs. Random POST data. Every API seems to be different” “REST uses the HTTP spec, but few API providers actually follow the spec properly.” 10/19/2011 9Thursday, October 27, 2011
  10. 10. “Guarantee me that any API you support will exist in its current form (bugs and all!) for at least 12 months, and I will give you so much fucking money.” 10/19/2011 10Thursday, October 27, 2011
  11. 11. “Guarantee me that any API you support will exist in its current form (bugs and all!) for at least 12 months, and I will give you so much fucking 10/19/2011 11Thursday, October 27, 2011
  12. 12. 10/19/2011 12Thursday, October 27, 2011
  13. 13. Where else are you losing Developers’ $$$?! 10/19/2011 13Thursday, October 27, 2011
  14. 14. Your Documentation Sucks “poor documentation” mentioned 41 times “lack of good examples + sandboxes” “Documentation and examples. Give me those, keep them up to date and I’m happy.” 10/19/2011 14Thursday, October 27, 2011
  15. 15. Y U No Update Documentation????? 10/19/2011 15Thursday, October 27, 2011
  16. 16. Your Error Handling and Test Environments Suck “error handling” a frequent complaint “Complete lack of test environments.” “The ones that you can’t test from a localhost suck” 10/19/2011 16Thursday, October 27, 2011
  17. 17. We suck more together Inconsistent standards, libraries, and documentation “REST vs. XML-RPC vs. SOAP, JSON vs. XML vs. Random POST data. Every API seems to be different” “Change is good, but change when it breaks existing 3rd party API’s is a nightmare.” 10/19/2011 17Thursday, October 27, 2011
  18. 18. We suck more together “Random 3rd party outages that take you out as well” Error Codes differ between services. On bad Auth, Some 404, others 401 or 403. And some 500. This is hell on devs. “Different data formats from different services for essentially the same data.” 10/19/2011 18Thursday, October 27, 2011
  19. 19. And there’s so much other confusion Authentication vs. Authorization Oh do developers hate OAuth (users, too!) Actually getting through to stakeholders (that’s YOU) Rate limiting and billing 10/19/2011 19Thursday, October 27, 2011
  20. 20. 10/19/2011 20Thursday, October 27, 2011
  21. 21. “Paypal. Sweet god, fuck paypal.” “OMFG Salesforce “Digg is basically a giant API sucks. That is example of ‘this is how to not all” do it’.” “Affiliate + API — “Netsuite SOAPs almost no one does it documentation is, umm… right.” completely fucking incorrect” “We’re still working on “Too many to relate.” it.” 10/19/2011 21Thursday, October 27, 2011
  22. 22. 10/19/2011 22Thursday, October 27, 2011
  23. 23. So let’s solve this. Together. 10/19/2011 23Thursday, October 27, 2011
  24. 24. 10/19/2011 24Thursday, October 27, 2011
  25. 25. More frequent and open communications We’re not in a vacuum! 10/19/2011 25Thursday, October 27, 2011
  26. 26. Humbleness You might be awesome, but together we make a shitty team 10/19/2011 26Thursday, October 27, 2011
  27. 27. Documentation-Driven Design Simply: Write and review documentation first, then write code 10/19/2011 27Thursday, October 27, 2011
  28. 28. Standards and best practices 10/19/2011 28Thursday, October 27, 2011
  29. 29. Developer Bill of Rights What can they expect from ALL of us? 10/19/2011 29Thursday, October 27, 2011
  30. 30. Hold our own accountable 10/19/2011 30Thursday, October 27, 2011
  31. 31. Better APIs = Happier Developers = Happier Customers = more $$$ 10/19/2011 31Thursday, October 27, 2011
  32. 32. Recap We’re not in this alone We need to start thinking like team players Cooperation amongst ourselves makes developers’ lives easier Which means better adoption, retention, and revenue 10/19/2011 32Thursday, October 27, 2011
  33. 33. Your Business is NOT your API. It is what that API provides access to. So fix your API and the ecosystem around it! 10/19/2011 33Thursday, October 27, 2011
  34. 34. Thank you #BAPI! http://bit.ly/trove-survey-results Jesse Emery, Co-Founder www.yourtrove.com j@yourtrove.com @ejesse 10/19/2011 34Thursday, October 27, 2011

×