revised readme to reflect current API spec
Merge pull request #12 from cloudspace/67475858_api_spec_update

revised readme to reflect current API spec