Better documentation of the HTTP API.

Specifically, add documentation on receiving events.