Minor updates to the readme.
Initial braindump of web api documentation.