Corvus Hilfe > Api > Yuna > Request Informationen

Request Informationen

Es gibt ein paar Datenfelder und Informationen die Grundsätzlich immer mitgeliefert werden. Dazugehören unter anderem die Timing Informationen, mit denen man ein Zeitverhalten messen kann.

Timing Information Block

Dieser Block liefert Zeitstempel vom Server. Alle Zeitstempel sind in Millisekunden und UTC. Darunter befinden sich die Informationen, wann ein Server die Anfrage bekommen hat, wann er es abgearbeitet hat, und wann er damit fertig war.

Jedoch kann aber auch der Client diesen Block benutzen, um seine eigenen Daten dort abzulegen. Da diese Daten auch wieder in der Antwort vorkommen, kann man so relativ simple eine Zeitmessung vornehmen, selbst dann, wenn der Client vollständig Asynchron arbeitet.

Der Block sieht in etwa so aus:

{
	"timingInformation": {
		"serverReceivedTimestampUtcMs": "1660299053342",
		"serverProcessingBeginTimestampUtcMs": "1660299053350",
		"serverProcessingEndTimestampUtcMs": "1660299053350"
	}
}

Und alternativ kann auch der Client dort Daten ablegen:

Gesendet:

{
	"auth": {
		"key": "123...xyz"
	},
	"action": "test",
	"timingInformation": {
		"clientSendTimestampUtcMs": "4711"
	}
}

Empfangen:

{
	"action": "test",
	"timingInformation": {
		"clientSendTimestampUtcMs": "4711",
		"serverReceivedTimestampUtcMs": "1660299172270",
		"serverProcessingBeginTimestampUtcMs": "1660299172286",
		"serverProcessingEndTimestampUtcMs": "1660299172286"
	}
}

Datenfelder

Name	Typ	Default	Beschreibung
`.timingInformation`	Record	-	Der Block für die Timing Informationen
`.timingInformation.serverReceivedTimestampUtcMs`	Long	-	Wann das Packet in den Server gelaufen ist
`.timingInformation.serverProcessingBeginTimestampUtcMs`	Long	-	Wann der Server angefangen hat die Aktion zu starten
`.timingInformation.serverProcessingEndTimestampUtcMs`	Long	-	Wann der Server mit der Bearbeitung der Aktion fertig wurde
`.timingInformation.clientBuildRequestDurationMs`	Long	-	Wie lange ein Client gebraucht hat um den Request vorzubereiten
`.timingInformation.clientSendTimestampUtcMs`	Long	-	Wann ein Client die Daten versendet hat
`.timingInformation.clientReceiveTimestampUtcMs`	Long	-	Wann ein Client die Daten bekommen hat

Eigenarten

Alle Werte, die mit client anfangen, werden vom Server identisch wieder zurückgeliefert, die kann ein Client benutzen, wenn er denn möchte, oder auch nicht. Der Server ignoriert diese Werte sowieso.