RequestHeader

Header-Objekt, das für alle an den Server gesendeten Anfragen definiert ist.

JSON-Darstellung
{
  "requestId": string,
  "requestTimestamp": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
Felder
requestId

string

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

string (int64 format)

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
(deprecated)

string

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 userMessage-Felder in der Antwort steuern.

protocolVersion

object (Version)

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

integer

ERFORDERLICH: Hauptversion. Bei Kompatibilitätsanfragen mit unterschiedlichen Versionen ist dies jedoch nicht garantiert.

minor

integer

ERFORDERLICH: Nebenversion. Dies weist auf erhebliche Fehlerkorrekturen hin.

revision

integer

ERFORDERLICH: Nebenversion. Das sind kleinere Fehlerkorrekturen.