4. Log Client Messages

4. Log Client Messages

Messages are sent as HTTPS GET or POST requests. Parameters for POSTs and all responses are encoded as JavaScript Object Notation (JSON) objects [RFC4627]. Parameters for GETs are encoded as order-independent key/value URL parameters, using the "application/x-www-form-urlencoded" format described in the "HTML 4.01 Specification" [HTML401]. Binary data is base64 encoded [RFC4648] as specified in the individual messages.

Note that JSON objects and URL parameters may contain fields not specified here. These extra fields should be ignored.

The <log server> prefix can include a path as well as a server name and a port.

In general, where needed, the "version" is v1 and the "id" is the log id for the log server queried.

Any errors will be returned as HTTP 4xx or 5xx responses, with human-readable error messages.