Update README.md

added API specs, etc