4. Log Client Messages (Log-Client-Nachrichten)

4. Log Client Messages (Log-Client-Nachrichten)

Nachrichten werden als HTTPS-GET- oder POST-Anfragen gesendet. Parameter für POSTs und alle Antworten sind als JavaScript Object Notation (JSON)-Objekte [RFC4627] kodiert. Parameter für GETs sind als reihenfolgeunabhängige Schlüssel/Wert-URL-Parameter im Format application/x-www-form-urlencoded gemäß „HTML 4.01 Specification“ [HTML401] kodiert. Binärdaten sind base64-kodiert [RFC4648], wie in den einzelnen Nachrichten angegeben.

JSON-Objekte und URL-Parameter können Felder enthalten, die hier nicht spezifiziert sind. Diese zusätzlichen Felder sollten ignoriert werden.

Das Präfix <log server> kann einen Pfad sowie einen Servernamen und einen Port umfassen.

Allgemein ist, wo nötig, die version v1 und die id die Log-ID des abgefragten Log-Servers.

Fehler werden als HTTP-4xx- oder 5xx-Antworten mit für Menschen lesbaren Fehlermeldungen zurückgegeben.