Api Specification Open For Review

The first version of the API specification has been written. 

Please take the time to look over the methods made available by the API and comment on this pull request any changes or suggestions. Changes can be made to the specification by working on the api branch. Once we've all agreed that the specification is clear enough to be used as endpoints for each client application then we'll merge this into the master branch.