the who, what, where, when, why, and how of apis

22
The WHO, WHAT, WHERE, WHEN, WHY, HOW* of Building APIs… (* not in that order) Javaun Moradi, NPR @javaun

Post on 22-Oct-2014

1.852 views

Category:

Documents


4 download

DESCRIPTION

Or, stuff we've learned the hard way while building APIs at NPR. This is a presentation I gave to the DC API meetup on 1/30/13

TRANSCRIPT

Page 1: The Who, What, Where, When, Why, and How of APIs

The WHO, WHAT, WHERE, WHEN, WHY, HOW* of Building APIs…

(* not in that order)

Javaun Moradi, NPR@javaun

Page 2: The Who, What, Where, When, Why, and How of APIs

(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

Page 3: The Who, What, Where, When, Why, and How of APIs

(Last background slide for a while)

NPR’s APIs• Stories• Stations• Schedules• Streams• Library data• Transcripts• …

Page 4: The Who, What, Where, When, Why, and How of APIs

WHY are APIs so sexy?

Page 5: The Who, What, Where, When, Why, and How of APIs

APIs are about the opportunities you don’t miss.

Page 6: The Who, What, Where, When, Why, and How of APIs

WHY do we love APIs?

• Keep pace with your product needs• Innovate quickly• Reuse, don’t reinvent• Serendipity

Page 7: The Who, What, Where, When, Why, and How of APIs

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)?

Page 8: The Who, What, Where, When, Why, and How of APIs

WHAT do you build?

Page 9: The Who, What, Where, When, Why, and How of APIs

Smart small(you can add more later)

Page 10: The Who, What, Where, When, Why, and How of APIs

Build for actual user problems(Don’t “liberate” data unless that’s your mission)

Page 11: The Who, What, Where, When, Why, and How of APIs

Intuitive and self-documenting(developers hate to read)

Page 12: The Who, What, Where, When, Why, and How of APIs

Drink your own… (be your first customer)

Page 13: The Who, What, Where, When, Why, and How of APIs

Build something imperfect. (Be ok with that.)

Page 14: The Who, What, Where, When, Why, and How of APIs

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?

Page 15: The Who, What, Where, When, Why, and How of APIs

WHO do you want to be? (Big IT vs. Leading the business)

Page 16: The Who, What, Where, When, Why, and How of APIs

WHO do you build it for?

Page 17: The Who, What, Where, When, Why, and How of APIs
Page 18: The Who, What, Where, When, Why, and How of APIs

WHERE should your API live?

public private

One size

Custom

• Data.gov• Sunlight Labs

• Netflix

• World Bank

• NPR API we use

• Google

• Twilio

• Open NPR API

• AP

Page 19: The Who, What, Where, When, Why, and How of APIs

HOW: DIY vs. Vendor

Page 20: The Who, What, Where, When, Why, and How of APIs

HOW do you support it?

Page 21: The Who, What, Where, When, Why, and How of APIs
Page 22: The Who, What, Where, When, Why, and How of APIs

Now what?(Hang on tight…)