• /authToken (POST a username/password, to receive an auth token for subsequent requests)
• /hubs/:hubID (Retreive Data about a Hub)
• /devices/:deviceID (Retreive Data about a Device)
• /devices/:deviceID/history (Retreive historic events of a device)

• Common Errors given back by the api
• What to do when a token expires

Endpoints should return json by default, if an accepts header is sent as text/html or a .html extension is added then output the docs for that call.

API should be RESTful - endpoints are nouns, JSON as payload etc.