RequestHeader

Obiekt nagłówka zdefiniowany we wszystkich żądaniach wysyłanych do serwera.

Zapis JSON
{
  "requestId": string,
  "requestTimestamp": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
Pola
requestId

string

WYMAGANE: unikalny identyfikator tego żądania.

Ma on maksymalnie 100 znaków i zawiera tylko znaki „a–z”, „A–Z”, „0–9”, „:”, „-” i „_”.

requestTimestamp

string (int64 format)

WYMAGANE: sygnatura czasowa tego żądania wyrażona w milisekundach od początku epoki. Odbiorca powinien sprawdzić, czy sygnatura czasowa ma 60 sekund na moment. Ta sygnatura czasowa żądania nie jest idempotentna przy ponownych próbach.

userLocale
(deprecated)

string

WYCOFANO: dwu- lub trzyliterowy kod języka w formacie ISO 639-2 alfa-3, opcjonalnie z łącznikiem i kodem kraju w formacie ISO 3166-1 alfa-2, np. „pt”, „pt-BR”, „fil” lub „fil-PH”. Aby pomóc w zwiększeniu liczby pól userMessage w odpowiedzi.

protocolVersion

object (Version)

WYMAGANE: wersja tego żądania.

Wersja

Obiekt wersji, który jest strukturą w strukturze klasycznej wersji a.b.c. Gwarantujemy, że główne wersje tego samego numeru są zgodne. Niewielkie zmiany i zmiany mogą być wprowadzane często i bez powiadomienia. Integrator musi obsługiwać wszystkie żądania dotyczące tej samej wersji głównej.

Zapis JSON
{
  "major": integer,
  "minor": integer,
  "revision": integer
}
Pola
major

integer

WYMAGANE: wersja główna. Nie ma gwarancji, że są one oznaczone w żądaniach zgodności z różnymi wersjami.

minor

integer

WYMAGANE: wersja podrzędna. Oznacza to istotne poprawki błędów.

revision

integer

WYMAGANE: wersja podrzędna. To oznacza poprawki błędów.