cooking with your api
DESCRIPTION
This deck is from my presentation on scaling the documentation of your API at API Strategy and Practice conference in Amsterdam in March 2014.TRANSCRIPT
Cooking With Your API
Andrew Noonan @noonisms
APIs are HARD …design
…implement …docs
…security …adoption
Hooray Adoption
mission accomplished happy users profit??
Adoption = = Scale
APIs can live and die by their
DOCUMENTATION
Lets Cook Something
ingredients flavors combos
recipes take away
Ingredients
API Reference
GET /streams/track/{label}.json
POST /streams/track/{label}/rules.json
DELETE/streams/track/{label}/rules.json
GET /streams/track/{label}/rules.json
FLAVOR combos
Overviews
Recipes
Demo Apps
SendGrid github.com/scottmotte/sendgrid-java-example Gnip github.com/gnip/search-api-rails-demo