This deck is from my presentation on scaling the documentation of your API at API Strategy and Practice conference in Amsterdam in March 2014.

1. Cooking With Your API
Andrew Noonan
@noonisms

2. APIs are HARD
…design
…implement
…docs
…security
…adoption

3. Hooray Adoption
mission accomplished
happy users
profit??

4. Adoption = = Scale

5. APIs can live and die by their
DOCUMENTATION

6. Lets Cook Something
ingredients
flavors combos
recipes
take away

7. Ingredients

8. 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

9. FLAVOR
combos

10. Overviews

11. Recipes

12. Demo Apps
SendGrid
github.com/scottmotte/sendgrid-java-example
Gnip
github.com/gnip/search-api-rails-demo