Update REST API document

[disrani-px]

The REST API document at http://api.openstorage.org seems to have fallen behind, it needs to be updated.

Also need to add more information about various states/members which are represented by numbers. Maybe also look in to automatically generating documentation using annotations in the code.