Header-Objekt, das für alle an den Server gesendeten Anfragen definiert ist.
JSON-Darstellung |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
Felder | |
---|---|
requestId |
ERFORDERLICH: Eindeutige Kennung dieser Anfrage. Dabei handelt es sich um eine Zeichenfolge mit einer maximalen Länge von 100 Zeichen, die nur die Zeichen "a-z", "A-Z", "0-9", ":", "-" und "_" enthält. |
requestTimestamp |
ERFORDERLICH: Zeitstempel dieser Anfrage in Millisekunden seit Epochzeit. Der Empfänger muss prüfen, ob dieser Zeitstempel ± 60 Sekunden von „jetzt“ lautet. Dieser Zeitstempel der Anfrage ist bei Wiederholungen nicht idempotent. |
userLocale |
VERWORFEN: Ein zwei- oder dreistelliger ISO 639-2 Alpha-3-Sprachcode, optional mit einem Bindestrich und einem ISO 3166-1 Alpha-2-Ländercode, z.B. „pt“, „pt-BR“, „fil“ oder „fil-PH“. Hiermit können Sie die |
protocolVersion |
ERFORDERLICH: Die Version dieser Anfrage. |
Version
Versionsobjekt, das eine strukturierte Form der klassischen a.b.c
-Versionsstruktur ist. Hauptversionen derselben Nummer sind garantiert kompatibel. Beachten Sie, dass sich Nebenversionen und Überarbeitungen häufig und ohne vorherige Ankündigung ändern können. Der Integrator muss alle Anfragen für dieselbe Hauptversion unterstützen.
JSON-Darstellung |
---|
{ "major": integer, "minor": integer, "revision": integer } |
Felder | |
---|---|
major |
ERFORDERLICH: Hauptversion. Bei Kompatibilitätsanfragen mit unterschiedlichen Versionen ist dies jedoch nicht garantiert. |
minor |
ERFORDERLICH: Nebenversion. Dies weist auf erhebliche Fehlerkorrekturen hin. |
revision |
ERFORDERLICH: Nebenversion. Das sind kleinere Fehlerkorrekturen. |