Method: echo

回显从客户端发送的字符串。

如果端点在处理请求时遇到错误,来自此端点的响应正文的类型应为 ErrorResponse

示例请求如下所示:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 2
    },
    "requestId": "G1MQ0YERJ0Q7LPM",
    "requestTimestamp": {
      "epochMillis": "1481899949606"
    },
    "paymentIntegratorAccountId": "InvisiCashUSA_USD"
  },
  "clientMessage": "Client echo message"
}

成功响应示例如下所示:


{
  "responseHeader": {
    "responseTimestamp": {
      "epochMillis":"1481899950236"
    }
  },
  "clientMessage": "Client echo message",
  "serverMessage": "Debug ID 12345"
}

HTTP 请求

POST https://www.integratorhost.example.com/v2/echo

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
字段
requestHeader

object (RequestHeader)

必需:所有请求的通用标头。

clientMessage

string

REQUIRED:要在响应中回显的消息。

响应正文

echo 方法的响应对象。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
字段
responseHeader

object (ResponseHeader)

必需:所有响应的通用标头。

clientMessage

string

必需:在请求中收到的消息。

serverMessage

string

可选:服务器消息,与回显的 clientMessage 无关。

RequestHeader

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

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

string

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

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

requestTimestamp

object (Timestamp)

必需:此请求的时间戳。接收方必须验证此时间戳是否为“现在”的 ±60 秒,如果不是,则拒绝请求。此请求时间戳在重试时不具有幂等性。

protocolVersion

object (Version)

必需:此请求的版本。

paymentIntegratorAccountId

string

必需:用于标识具有合同限制的唯一帐号。