RequestHeader

在发送到服务器的所有请求中定义的标头对象。

JSON 表示法
{
  "requestId": string,
  "requestTimestamp": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
字段
requestId

string

必需:此请求的唯一标识符。

这是一个字符串,长度上限为 100 个字符,且仅包含字符“a-z”、“A-Z”、“0-9”、“:”、“-”和“_”。

requestTimestamp

string (int64 format)

必需:此请求的时间戳,以从公元纪年开始计算的毫秒数表示。接收方应验证此时间戳是否为“现在”的 ±60 秒。此请求时间戳在重试时不遵循幂等原则。

userLocale
(deprecated)

string

已弃用:由两个或三个字母组成的 ISO 639-2 Alpha 3 语言代码,后面可加上连字符和 ISO 3166-1 Alpha-2 国家/地区代码,例如“pt”、“pt-BR”、“fil”或“fil-PH”。使用此方法来帮助确定响应中的 userMessage 字段。

protocolVersion

object (Version)

必需:此请求的版本。

版本

Version 对象,它是传统版 a.b.c 版本结构的结构化形式。同一版本号的主要版本保证是兼容的。请注意,次要和修订可能会频繁更改,恕不另行通知。集成商必须支持针对同一主要版本的所有请求。

JSON 表示法
{
  "major": integer,
  "minor": integer,
  "revision": integer
}
字段
major

integer

必需:主要版本。针对与不同版本的兼容性请求进行标记,不保证兼容。

minor

integer

必需:次要版本。这表示存在重大问题修复。

revision

integer

必需:次要版本。这表示修复了一些小 bug。