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

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