Objeto de cabeçalho definido em todas as solicitações enviadas ao servidor.
Representação JSON |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
Campos | |
---|---|
requestId |
OBRIGATÓRIO: identificador exclusivo dessa solicitação. Essa é uma string de até 100 caracteres que contém somente os caracteres "a-z", "A-Z", "0-9", ":", "-" e "_". |
requestTimestamp |
OBRIGATÓRIO: carimbo de data/hora desta solicitação representado em milissegundos desde a época. O destinatário precisa verificar se esse carimbo de data/hora é ± 60s de "agora". Esse carimbo de data/hora da solicitação não é idempotente em novas tentativas. |
userLocale |
DESCONTINUADO: um código de idioma ISO 639-2 Alfa 3 de duas ou três letras, opcionalmente, seguido por um hífen e um código de país ISO 3166-1 Alfa 2, por exemplo, "pt", "pt-BR", "fil" ou "fil-PH". Use isso para ajudar a direcionar os campos |
protocolVersion |
OBRIGATÓRIO: a versão da solicitação. |
Versão
Objeto de versão, que é uma forma estruturada da estrutura de versão a.b.c
clássica. As versões principais com o mesmo número são compatíveis. Observe que pequenas e revisões podem mudar com frequência e sem aviso prévio. O integrador precisa ser compatível com todas as solicitações da mesma versão principal.
Representação JSON |
---|
{ "major": integer, "minor": integer, "revision": integer } |
Campos | |
---|---|
major |
OBRIGATÓRIO: versão principal. Isso é marcado para solicitações de compatibilidade com versões diferentes, mas não é garantido que elas sejam compatíveis. |
minor |
OBRIGATÓRIO: versão secundária. Isso indica correções de bugs significativas. |
revision |
OBRIGATÓRIO: versão secundária. Isso indica pequenas correções de bug. |