Obiekt nagłówka zdefiniowany we wszystkich żądaniach wysyłanych do serwera.
Zapis JSON |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
Pola | |
---|---|
requestId |
WYMAGANE: unikalny identyfikator tego żądania. Ma on maksymalnie 100 znaków i zawiera tylko znaki „a–z”, „A–Z”, „0–9”, „:”, „-” i „_”. |
requestTimestamp |
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 |
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 |
protocolVersion |
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 |
WYMAGANE: wersja główna. Nie ma gwarancji, że są one oznaczone w żądaniach zgodności z różnymi wersjami. |
minor |
WYMAGANE: wersja podrzędna. Oznacza to istotne poprawki błędów. |
revision |
WYMAGANE: wersja podrzędna. To oznacza poprawki błędów. |