SlideShare a Scribd company logo
The
WHO, WHAT, WHERE, WHEN, WHY,
   HOW* of Building APIs…
          (* not in that order)
       Javaun Moradi, NPR
            @javaun
(This slide isn’t a “W” or “H”)
•   NPR Open API launched in 2008
•   Try it: http://dev.npr.org or Codecademy.com
•   Powers all of NPR’s mobile, web, cars apps
•   100+ stations retrieve content & add their
    own
(Last background slide for a while)
NPR’s APIs
• Stories
• Stations
• Schedules
• Streams
• Library data
• Transcripts
• …
WHY are APIs so sexy?
APIs are about the opportunities
         you don’t miss.
WHY do we love APIs?
•   Keep pace with your product needs
•   Innovate quickly
•   Reuse, don’t reinvent
•   Serendipity
WHEN is it time to get an API?
•   Mobile aspirations?
•   Data/services useful in more than one place?
•   Departments need to share/collaborate?
•   Decouple your systems?
•   Be more nimble?
•   Share your service (free or for profit)?
WHAT do you build?
Smart small
(you can add more later)
Build for actual user problems
  (Don’t “liberate” data unless that’s your mission)
Intuitive and self-documenting
         (developers hate to read)
Drink your own…
  (be your first customer)
Build something imperfect.
        (Be ok with that.)
WHAT should you measure?
•   Speed, for starters
•   Usage is great for management
•   Do you monetize your API?
•   Numbers don’t tell you value
•   Do you measure other tools?
WHO do you want to be?
    (Big IT vs. Leading the business)
WHO do you build it for?
WHERE should your API live?
•   Data.gov                       One size
    • Sunlight Labs                                        •       AP
     • World Bank


               •    Open NPR API      •   NPR API we use



      public                                                       private
               •    Twilio

                •     Google




                                     Custom                    •    Netflix
HOW: DIY vs. Vendor
HOW do you support it?
Now what?
 (Hang on tight…)

More Related Content

Similar to The Who, What, Where, When, Why, and How of APIs

Alibaba Technology in 2018
Alibaba Technology in 2018Alibaba Technology in 2018
Alibaba Technology in 2018
Liangjun Jiang
 
2021 05-08 building ai product - experience
2021 05-08 building ai product - experience2021 05-08 building ai product - experience
2021 05-08 building ai product - experience
Kien Le
 
Social dev camp_2011
Social dev camp_2011Social dev camp_2011
Social dev camp_2011
Craig Ulliott
 
Platform Selection
Platform SelectionPlatform Selection
Platform Selection
Wilco van Duinkerken
 
Mobeers waterloo-2011
Mobeers waterloo-2011Mobeers waterloo-2011
Mobeers waterloo-2011
Brian LeRoux
 
Tech Thursdays: Building Products
Tech Thursdays: Building ProductsTech Thursdays: Building Products
Tech Thursdays: Building Products
Hayden Bleasel
 
Welcome to Titanium
Welcome to TitaniumWelcome to Titanium
Welcome to Titanium
Axway Appcelerator
 
SumitK's mobile app dev using drupal as base ststem
SumitK's mobile app dev using drupal as base ststemSumitK's mobile app dev using drupal as base ststem
SumitK's mobile app dev using drupal as base ststem
Sumit Kataria
 
STC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based ApproachSTC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based Approach
Lois Patterson
 
Your API Deserves More Respect: Make It A Product
Your API Deserves More Respect: Make It A ProductYour API Deserves More Respect: Make It A Product
Your API Deserves More Respect: Make It A Product
ProgrammableWeb
 
MLOps for living: Infrastructure-as-Code on AWS
MLOps for living: Infrastructure-as-Code on AWSMLOps for living: Infrastructure-as-Code on AWS
MLOps for living: Infrastructure-as-Code on AWS
AntonChernov9
 
PyData Texas 2015 Keynote
PyData Texas 2015 KeynotePyData Texas 2015 Keynote
PyData Texas 2015 Keynote
Peter Wang
 
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Nordic APIs
 
Let's Talk About APIs - Iloveapis2013 - keynote
Let's Talk About APIs - Iloveapis2013 - keynoteLet's Talk About APIs - Iloveapis2013 - keynote
Let's Talk About APIs - Iloveapis2013 - keynote
Apigee | Google Cloud
 
Documenting APIs (with many pictures of cats) - APIStrat
Documenting APIs (with many pictures of cats) - APIStratDocumenting APIs (with many pictures of cats) - APIStrat
Documenting APIs (with many pictures of cats) - APIStrat
Anya Stettler
 
Perso.na
Perso.naPerso.na
Perso.na
betabeers
 
LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...
LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...
LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...
LF_APIStrat
 
Building a Startup in .NET
Building a Startup in .NETBuilding a Startup in .NET
Building a Startup in .NET
Marcelo Calbucci
 
RAML - APIs By Design
RAML - APIs By DesignRAML - APIs By Design
RAML - APIs By Design
Uri Sarid
 
2014 Picking a Platform by Anand Kulkarni
2014 Picking a Platform by Anand Kulkarni2014 Picking a Platform by Anand Kulkarni
2014 Picking a Platform by Anand Kulkarni
European Innovation Academy
 

Similar to The Who, What, Where, When, Why, and How of APIs (20)

Alibaba Technology in 2018
Alibaba Technology in 2018Alibaba Technology in 2018
Alibaba Technology in 2018
 
2021 05-08 building ai product - experience
2021 05-08 building ai product - experience2021 05-08 building ai product - experience
2021 05-08 building ai product - experience
 
Social dev camp_2011
Social dev camp_2011Social dev camp_2011
Social dev camp_2011
 
Platform Selection
Platform SelectionPlatform Selection
Platform Selection
 
Mobeers waterloo-2011
Mobeers waterloo-2011Mobeers waterloo-2011
Mobeers waterloo-2011
 
Tech Thursdays: Building Products
Tech Thursdays: Building ProductsTech Thursdays: Building Products
Tech Thursdays: Building Products
 
Welcome to Titanium
Welcome to TitaniumWelcome to Titanium
Welcome to Titanium
 
SumitK's mobile app dev using drupal as base ststem
SumitK's mobile app dev using drupal as base ststemSumitK's mobile app dev using drupal as base ststem
SumitK's mobile app dev using drupal as base ststem
 
STC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based ApproachSTC Summit 2015: API Documentation, an Example-Based Approach
STC Summit 2015: API Documentation, an Example-Based Approach
 
Your API Deserves More Respect: Make It A Product
Your API Deserves More Respect: Make It A ProductYour API Deserves More Respect: Make It A Product
Your API Deserves More Respect: Make It A Product
 
MLOps for living: Infrastructure-as-Code on AWS
MLOps for living: Infrastructure-as-Code on AWSMLOps for living: Infrastructure-as-Code on AWS
MLOps for living: Infrastructure-as-Code on AWS
 
PyData Texas 2015 Keynote
PyData Texas 2015 KeynotePyData Texas 2015 Keynote
PyData Texas 2015 Keynote
 
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
Introduction to The 6 Insights of API Practice (Bill Doerrfeld)
 
Let's Talk About APIs - Iloveapis2013 - keynote
Let's Talk About APIs - Iloveapis2013 - keynoteLet's Talk About APIs - Iloveapis2013 - keynote
Let's Talk About APIs - Iloveapis2013 - keynote
 
Documenting APIs (with many pictures of cats) - APIStrat
Documenting APIs (with many pictures of cats) - APIStratDocumenting APIs (with many pictures of cats) - APIStrat
Documenting APIs (with many pictures of cats) - APIStrat
 
Perso.na
Perso.naPerso.na
Perso.na
 
LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...
LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...
LF_APIStrat17_Connect Your RESTful API to Hundreds of Others in Minutes (Zapi...
 
Building a Startup in .NET
Building a Startup in .NETBuilding a Startup in .NET
Building a Startup in .NET
 
RAML - APIs By Design
RAML - APIs By DesignRAML - APIs By Design
RAML - APIs By Design
 
2014 Picking a Platform by Anand Kulkarni
2014 Picking a Platform by Anand Kulkarni2014 Picking a Platform by Anand Kulkarni
2014 Picking a Platform by Anand Kulkarni
 

The Who, What, Where, When, Why, and How of APIs

  • 1. The WHO, WHAT, WHERE, WHEN, WHY, HOW* of Building APIs… (* not in that order) Javaun Moradi, NPR @javaun
  • 2. (This slide isn’t a “W” or “H”) • NPR Open API launched in 2008 • Try it: http://dev.npr.org or Codecademy.com • Powers all of NPR’s mobile, web, cars apps • 100+ stations retrieve content & add their own
  • 3. (Last background slide for a while) NPR’s APIs • Stories • Stations • Schedules • Streams • Library data • Transcripts • …
  • 4. WHY are APIs so sexy?
  • 5. APIs are about the opportunities you don’t miss.
  • 6. WHY do we love APIs? • Keep pace with your product needs • Innovate quickly • Reuse, don’t reinvent • Serendipity
  • 7. WHEN is it time to get an API? • Mobile aspirations? • Data/services useful in more than one place? • Departments need to share/collaborate? • Decouple your systems? • Be more nimble? • Share your service (free or for profit)?
  • 8. WHAT do you build?
  • 9. Smart small (you can add more later)
  • 10. Build for actual user problems (Don’t “liberate” data unless that’s your mission)
  • 11. Intuitive and self-documenting (developers hate to read)
  • 12. Drink your own… (be your first customer)
  • 13. Build something imperfect. (Be ok with that.)
  • 14. WHAT should you measure? • Speed, for starters • Usage is great for management • Do you monetize your API? • Numbers don’t tell you value • Do you measure other tools?
  • 15. WHO do you want to be? (Big IT vs. Leading the business)
  • 16. WHO do you build it for?
  • 17.
  • 18. WHERE should your API live? • Data.gov One size • Sunlight Labs • AP • World Bank • Open NPR API • NPR API we use public private • Twilio • Google Custom • Netflix
  • 19. HOW: DIY vs. Vendor
  • 20. HOW do you support it?
  • 21.
  • 22. Now what? (Hang on tight…)

Editor's Notes

  1. The reality is that NPR, stations, and partners were almost all of the usage.
  2. This is not an authoritative depiction of where these APIs live, it’s an exercise I used to think about where our APIs should live and how much resources/time should go into each area.
  3. The space is really nascent. We don’t know where it’s going to go. It is critical to our business and we want to be in full control of our roadmap. It’s our core technology, we’re invested.