Method: echo

傳回傳遞的 clientMessage

這個方法旨在測試付款整合商與 Google 之間的基本連線能力。

Google 每分鐘可能會使用有效或無效參數多次呼叫這個方法,藉此測試安全限制的保留設定。Google 也會在整合商的指示及 Google 指示的指示,隨時呼叫此方法。Google 每 10 秒呼叫一次的頻率,絕不會超過 30 次,在 15 分鐘內則不會超過 30 次。

安全性限制測試的例子包括但不限於:

  • 進行測試以確保付款整合商的端點不會交涉出較弱的加密套件。
  • 進行測試,確保付款整合商的端點不會與任何 TLS 1.2 交涉
  • 進行測試來確認付款整合商的端點不支援 HTTP。
  • 進行測試,確保付款整合商的端點至少要求一組已知的 PGP 簽署金鑰。
  • 進行測試,確保付款整合商端點支援已過期和啟用的多個 PGP 金鑰簽章,包括已知與未知。
  • 進行測試來確保付款整合商僅支援嚴格的 JSON 剖析功能。

如果端點在處理要求時發生錯誤,來自此端點的回應主體應為 ErrorResponse 類型。

要求範例如下:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "ZWNobyB0cmFuc2FjdGlvbg",
    "requestTimestamp": "1481899949606"
  },
  "clientMessage": "client message"
}

回應範例如下所示:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "clientMessage": "client message",
  "serverMessage": "server message"
}

HTTP 要求

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

要求主體

要求主體的資料會採用以下結構:

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

object (RequestHeader)

必要項目:所有要求的通用標頭。

clientMessage

string

必要項目:在回應中要傳送回音的訊息。

回應主體

echo 方法的回應物件。

如果成功,回應主體會含有以下結構的資料:

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

object (ResponseHeader)

必要項目:所有回應的通用標頭。

clientMessage

string

必要項目:在要求中收到的訊息。

serverMessage

string

選用:伺服器訊息,與要回應的 clientMessage 無關。