Update README.md

README is now slightly more truthy. Also contains a full API spec.