Client side JSON API documentation

There's quite a lot of JSON involved  in the client-side communications now.
We should probably document how it works.
I wrote most of the JSON interactions myself, so it's probably my job to document it, though some input on the parts I didn't write will be required.
