README

@philips @xiangli-cmu

I did a bunch of clean up on the `README` for spelling, grammar and to correct for changes in the API responses. I ran through the whole document and everything is working except for one line that uses the client certificate. I'll mark it with a line note.