Update README.md

Add API calls to documentation
Merge pull request #2 from 3scale/docs

Update README.md