[bug 788281] Document and tweak events api

* change date filters to be consisten with other api end points
* change product filter to "products"
* document the events api
* add FIXMEs for things that should get fixed
* add some really basic tests for the API endpoint

r?