Document kronos HTTP API

Maybe note that we use JSON Schema v4, http://json-schema.org/documentation.html.