Be more confident that the API is RESTful
Add more detail to the README