Method: echo

İstemciden gönderilen bir dizeyi geri döndürür.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan gelen yanıt ErrorResponse türünde olur.

Bu yöntem bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Net bir açıklamaya sahip ErrorResponse, bir saldırganın diğer entegratörlerin ödeme entegratörü hesap tanımlayıcısını anlamasına yardımcı olmak için kullanılabileceği durumlarda yanıt gövdesi boştur. İmzalama anahtarının eşleşmediği, ödeme entegratörü tanımlayıcısının bulunamadığı veya şifreleme anahtarının bilinmediği bu durumlarda bu yöntem, gövdesi boş olan bir HTTP 404 döndürür. İstek imzası doğrulanabildiyse yanıt gövdesinde hatayla ilgili ek bilgiler döndürülür.

Örnek bir istek şu şekilde görünür:


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

Bir başarı yanıtı örneği:


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

HTTP isteği

POST https://vgw.googleapis.com/secure-serving/gsp/v2/echo/:PIAID

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak başlık.
clientMessage

string

ZORUNLU: Yanıtta yankılanacak mesaj.

Yanıt gövdesi

Yankı yöntemi için yanıt nesnesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
Alanlar
responseHeader

object (ResponseHeader)

ZORUNLU: Tüm yanıtlar için ortak başlık.
clientMessage

string

ZORUNLU: İstekte mesaj alındı.
serverMessage

string

İSTEĞE BAĞLI: Yankılan clientMessage'den bağımsız olarak sunucu mesajı.

RequestHeader

Sunucuya gönderilen tüm isteklerde tanımlanan başlık nesnesi.

JSON gösterimi 
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
Alanlar
requestId

string

ZORUNLU: Bu isteğin benzersiz tanımlayıcısı.

Bu dize en fazla 100 karakter uzunluğunda olup yalnızca "a-z", "A-Z", "0-9", ":", "-" ve "_" karakterlerinden oluşur.
requestTimestamp

object (Timestamp)

ZORUNLU: Bu isteğin zaman damgası. Alıcı, bu zaman damgasının "şimdi" ± 60 saniye olduğunu doğrulamalı, değilse isteği reddetmelidir. Bu istek zaman damgası yeniden denemelerden sonra eş değerde değil.
protocolVersion

object (Version)

ZORUNLU: Bu isteğin sürümü.
paymentIntegratorAccountId

string

ZORUNLU: Sözleşmeden doğan kısıtlamalara sahip benzersiz bir hesap tanımlar.