對傳入的 clientMessage
發出回音。
這種方法的目的是測試付款整合商與 Google 之間的基本連線能力。
Google 可能會每分鐘呼叫這個方法多次,其中包含有效或無效的參數,以便測試是否能夠正確保留安全性限制條件。Google 也會依照整合商的指示和 Google 的指示,特別稱呼這個方法。Google 每 10 秒會快速呼叫一次,在 15 分鐘內最多呼叫 30 次。
安全性限制測試的例子包括但不限於:
- 進行測試,確保付款整合商的端點不會交涉低強度加密套件。
- 進行測試,確保付款整合商的端點只會交涉 TLS 1.2 版本的任何項目
- 進行測試,確保付款整合商的端點不支援 HTTP。
- 進行測試,確保付款整合商的端點至少要求一個已知的 PGP 簽署金鑰。
- 進行測試來確保付款整合商的端點支援多種已知和未知的 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 |
必要項目:回應中的 echo 訊息。 |
回應主體
echo 方法的回應物件。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"responseHeader": {
object ( |
欄位 | |
---|---|
responseHeader |
必要項目:所有回應的通用標頭。 |
clientMessage |
必要項目:要求中收到的訊息。 |
serverMessage |
選用:伺服器訊息,與被回應的 |