#this equals that api
These are all suggestions - I'm not an API designer - I've just consumed good and bad API's in my time.
Things I consider a good API - USGS - http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_hour.geojson
A bad api example - flickr - they have numbers as strings and a stupid "root" object.