Update rest-api.markdown

Update rest-api documentation
Merge pull request #198 from yohanakh/patch-2

Update rest-api.markdown