jesse emery, your trove

Download Jesse Emery, Your Trove

Post on 22-Oct-2014

1.007 views

Category:

Technology

1 download

Embed Size (px)

DESCRIPTION

NYC BAPI 2011 Speaker Presentation

TRANSCRIPT

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

j@yourtrove.com@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

j@yourtrove.com@ejesse

34

Thursday, October 27, 2011