Download - Jesse Emery, Your Trove
Slide 1
10/19/2011
Why Your API SucksBusiness of APIs Conference, NY, 10/19/2011
An API developer survey opens Pandoras Boxhttp://bit.ly/trove-survey-results
Jesse Emery, Co-Founderwww.yourtrove.com
[email protected]@ejesse
#apisuck1
Thursday, October 27, 2011
10/19/2011
We did a survey on API PainIt made some waves
You can view it here:
http://bit.ly/trove-survey-results
2
Thursday, October 27, 2011
10/19/2011
Facebook Wins Worst API in Developer Survey- TechCrunch
3
Developers relate a tale of woe with Facebook's API
- The Inquirer
Developer survey finds Facebook has the worst API- ZD Net
Thursday, October 27, 2011
10/19/2011
Booooring
Its no real secret that Facebooks API is widely loathed
4
Thursday, October 27, 2011
10/19/2011 5
Thursday, October 27, 2011
10/19/2011
Developers Hate Your API
Every integration is its own [expletive-deleted] adventure.
6
Thursday, October 27, 2011
10/19/2011
APIs dont live in a vacuum
7
Thursday, October 27, 2011
10/19/2011
APIs dont live in a vacuum
8
Thursday, October 27, 2011
10/19/2011
different idiosyncrasies, ie rate limiting, terms of service, data format, old documentation etc.
9
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.
Thursday, October 27, 2011
10/19/2011
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
Thursday, October 27, 2011
10/19/2011
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 11
Thursday, October 27, 2011
10/19/2011 12
Thursday, October 27, 2011
10/19/2011
Where else are you losing Developers $$$?!
13
Thursday, October 27, 2011
10/19/2011
Your Documentation Sucks
14
poor documentation mentioned 41 times
lack of good examples + sandboxes
Documentation and examples. Give me those, keep them up to date and Im happy.
Thursday, October 27, 2011
10/19/2011
Y U No Update Documentation?????
15
Thursday, October 27, 2011
10/19/2011
Your Error Handling andTest Environments Suck
16
error handling a frequent complaint
Complete lack of test environments.
The ones that you cant test from a localhost suck
Thursday, October 27, 2011
10/19/2011
We suck more together
17
Inconsistent standards, libraries, and documentation
Change is good, but change when it breaks existing 3rd party APIs is a nightmare.
REST vs. XML-RPC vs. SOAP,JSON vs. XML vs. Random POST data.Every API seems to be different
Thursday, October 27, 2011
10/19/2011
We suck more together
18
Random 3rd party outages that take you out as well
Different data formats from different services for essentially the same data.
Error Codes differ between services.On bad Auth, Some 404, others 401 or 403.
And some 500. This is hell on devs.
Thursday, October 27, 2011
10/19/2011
Authentication vs. Authorization
19
Oh do developers hate OAuth(users, too!)
Actually getting through to stakeholders (thats YOU)
And theres so much other confusion
Rate limiting and billing
Thursday, October 27, 2011
10/19/2011 20
Thursday, October 27, 2011
10/19/2011 21
Paypal. Sweet god, fuck paypal. OMFG Salesforce API sucks. That is all
Were still working on it.
Netsuite SOAPs documentation is, umm completely fucking incorrect
Affiliate + API almost no one does it
right.
Digg is basically a giant example of this is how to not
do it.
Too many to relate.
Thursday, October 27, 2011
10/19/2011 22
Thursday, October 27, 2011
10/19/2011
So lets solve this. Together.
23
Thursday, October 27, 2011
10/19/2011 24
Thursday, October 27, 2011
10/19/2011
More frequent and open communications
Were not in a vacuum!
25
Thursday, October 27, 2011
10/19/2011
Humbleness
26
You might be awesome, but together we make a shitty team
Thursday, October 27, 2011
10/19/2011
Documentation-Driven DesignSimply: Write and review documentation first, then write code
27
Thursday, October 27, 2011
10/19/2011
Standards and best practices
28
Thursday, October 27, 2011
10/19/2011
Developer Bill of Rights
29
What can they expect from ALL of us?
Thursday, October 27, 2011
10/19/2011
Hold our own accountable
30
Thursday, October 27, 2011
10/19/2011
Better APIs = Happier Developers = Happier Customers = more $$$
31
Thursday, October 27, 2011
10/19/2011
Recap
32
Were 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
Thursday, October 27, 2011
10/19/2011
Your Business is NOT your API. It is what that API provides access to.
So fix your API and the ecosystem around it!
33
Thursday, October 27, 2011
10/19/2011
Thank you #BAPI!
http://bit.ly/trove-survey-results
Jesse Emery, Co-Founderwww.yourtrove.com
[email protected]@ejesse
34
Thursday, October 27, 2011