final document for api v1

* added versioning info
* added authentication details
* added few additional attributes
* added a changelog