可回應用戶端傳送的字串。
如果端點在處理要求時發生錯誤,來自這個端點的回應就會是
類型。ErrorResponse
如果這個方法未傳回 HTTP 200,這項查詢的回應可能會空白。在某些情況下,使用
搭配清楚的說明,協助攻擊者瞭解其他整合商的帳戶 ID,則回應主體是空白的。在這類情況下,只要簽署金鑰不相符、找不到付款整合商 ID,或是加密金鑰不明,這個方法就會傳回主體為空白的 HTTP 404。如果要求簽章可供驗證,回應主體中會傳回與錯誤相關的其他資訊。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://vgw.googleapis.com/secure-serving/gsp/v2/echo/:PIAID
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"requestHeader": {
object ( |
欄位 | |
---|---|
requestHeader |
必要項目:所有要求的通用標頭。 |
clientMessage |
必要項目:回應中的 echo 訊息。 |
回應主體
echo 方法的回應物件。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"responseHeader": {
object ( |
欄位 | |
---|---|
responseHeader |
必要項目:所有回應的通用標頭。 |
clientMessage |
必要項目:要求中收到的訊息。 |
serverMessage |
選用:伺服器訊息,與被回應的 |
RequestHeader
針對傳送至伺服器的所有要求所定義的標頭物件。
JSON 表示法 |
---|
{ "requestId": string, "requestTimestamp": { object ( |
欄位 | |
---|---|
requestId |
必要項目:這項要求的專屬 ID。 這是一個長度上限為 100 個字元的字串,並且只包含「a-z」、「A-Z」、「0-9」、「:」、「-」和「_」等字元。 |
requestTimestamp |
必要項目:這項要求的時間戳記。接收端必須驗證這個時間戳記是「現在」的 ±60 號,如果並非「現在」,請拒絕要求。重試時,此要求時間戳記並不是冪等的。 |
protocolVersion |
必要項目:這項要求的版本。 |
paymentIntegratorAccountId |
必要項目:識別具有合約限制的專屬帳戶。 |