Your API Sucks! Why developers hang up and how to stop that.

7,642
-1

Published on

Part 6 in our series of API Best Practices Webinars - on Developer Adoption- by @landlessness and @earth2marsh

Published in: Technology, Business
1 Comment
4 Likes
Statistics
Notes
  • <br /><iframe width="350" height="288" src="http://www.youtube.com/embed/twWnGnQG_1s" frameborder="0"></iframe>
       Reply 
    Are you sure you want to  Yes  No
    Your message goes here
No Downloads
Views
Total Views
7,642
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
61
Comments
1
Likes
4
Embeds 0
No embeds

No notes for slide

Your API Sucks! Why developers hang up and how to stop that.

  1. 1. Your  API  Sucks  Why  developers  hang  up  and  how  to  stop  that.  Rapid  API  Workshop  Marsh  Gardiner      Brian  Mulloy  @earth2marsh      @landlessness    
  2. 2. @earth2marsh @landlessness
  3. 3. Rapid API Workshop Webinar SeriesMapping  out  your  API  Strategy    PragmaAc  REST:  API  Design  Fu  10  PaJerns  of  Successful  API  Programs  API  Metrics  –  What  to  Measure?  API  Technology  &  OperaAons  Today:  Your  API  Sucks!  PCI  Compliance  and  APIs    
  4. 4. THIS TALKIN A NUTSHELL•   User  experience  wins  •   API  users  =  developers  •   Developer  experiences  (generally)  suck  •   But  they  don’t  have  to…  
  5. 5. #betterapis!
  6. 6. Four simple rules1. Give developers every reason to build2. Make them successful faster3. Dont violate their trust4. Listen
  7. 7. Hangup Reason #1Why would I use your API?
  8. 8. Why  did  you  build  an  API?  
  9. 9. Four simple rules1. Give developers every reason to build2. Make them successful faster3. Dont violate their trust4. Listen
  10. 10. Simple  things  should  be  simple.  Complex  things  should  be  possible.              —  Alan  Kay  
  11. 11. Krug says:1. People don’t read pages. They scan them.2. People don’t make optimal choices. They satisfice.3. People don’t figure out how things work. They muddle through.
  12. 12. Hangup Reason #2You’re making this too hard.
  13. 13. TTFR Time   To   First   Request  
  14. 14. Four simple rules1. Give developers every reason to build2. Make them successful faster3. Dont violate their trust4. Listen
  15. 15. Hangup Reason #3Are you going to support me?
  16. 16. Four simple rules1. Give developers every reason to build2. Make them successful faster3. Dont violate their trust4. Listen
  17. 17. Your  API  is  a  product.  Treat  it  that  way.  Your  developers  are  your  customers.  
  18. 18. Why  is  this  so  hard?  
  19. 19. Why  does  Freemium  work?  
  20. 20. Do  it  beIer  
  21. 21. SOAP   POST /InStock HTTP/1.1 Host: www.example.org Content-Type: application/soap+xml; charset=utf-8 Content-Length: 299 <?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"> <soap:Header> </soap:Header> <soap:Body> <m:GetStockPrice xmlns:m="http://www.example.org/stock"> <m:StockName>IBM</m:StockName> </m:GetStockPrice> </soap:Body> </soap:Envelope>
  22. 22. Why  REST  is  winning:  http://api.twitter.com/1/statuses/public_timeline.json
  23. 23. Your  engineers  may  be  great  at  wriAng  the  code  behind  your  API.    Are  they  great  at  designing  for  API  adop<on?    
  24. 24. POST !https://api.bluevia.com/services/REST/Advertising_Sandbox/simple/requests?version=v1!
  25. 25. Opacity  is  inscrutable.  (Also,  unforgivable.)  Give  devs  the  informa<on  they  need  to  succeed.  
  26. 26. Good  PaIerns  
  27. 27. Put  yourself  in  their  shoes.  
  28. 28. Four simple rules1. Give developers every reason to build2. Make them successful faster3. Dont violate their trust4. Listen
  29. 29. Rapid API Workshop Webinar SeriesMapping  out  your  API  Strategy    PragmaAc  REST:  API  Design  Fu  10  PaJerns  in  Successful  API  Programs  Today:  API  Metrics  –  What  to  Measure?  API  Technology  &  OperaAons  Your  API  Sucks!  Next:  PCI  Compliance  and  APIs  
  30. 30. Tired I am. REST I must.
  31. 31. THANKS!    Send  ques<ons,  examples,  and  ideas  to  @apigee   Marsh  Gardiner      Brian  Mulloy   marsh@apigee.com      brian@apigee.com   @earth2marsh      @landlessness    

×