Method: echo

Aktarılan clientMessage öğesini geri döndürür.

Bu yöntemin amacı, ödeme entegratörü ile Google arasındaki temel bağlantıyı test etmektir.

Bu yöntem, güvenlik kısıtlamalarının doğru bir şekilde korunduğunu test etmek için Google tarafından geçerli veya geçersiz parametrelerle dakikada birden çok kez çağrılabilir. Google, bu yöntemi hem entegratörün hem de Google'ın istediği şekilde geçici olarak adlandırır. Google bunu hiçbir zaman 10 saniyede bir defadan daha hızlı ve 15 dakikalık bir pencerede en fazla 30 kez çağırır.

Güvenlik kısıtlaması testlerine örnek olarak aşağıdakiler verilebilir (örnekler bunlarla sınırlı değildir):

  • Ödeme entegratörünün uç noktasının zayıf şifre paketleriyle pazarlık yapmadığından emin olmak için test yapın.
  • Ödeme entegratörünün uç noktasının TLS 1.2 dışında bir anlaşma yapmadığından emin olmak için test yapın
  • Ödeme entegratörünün uç noktasının HTTP'yi desteklemediğinden emin olmak için test yapın.
  • Ödeme entegratörünün uç noktasının, bilinen en az bir PGP imzalama anahtarı gerektirdiğinden emin olmak için test yapın.
  • Ödeme entegratörünün uç noktasının, bilinen ve bilinmeyen birden çok PGP anahtar imzasını (hem süresi dolmuş hem de etkin) desteklediğinden emin olmak için test yapın.
  • Ödeme entegratörünün yalnızca katı JSON ayrıştırmayı desteklediğinden emin olmak için test yapın.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktanın yanıt gövdesi ErrorResponse türünde olmalıdır.

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


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

Örnek bir yanıt şöyle görünür:


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

HTTP isteği

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

İ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": string,
  "userLocale": string,
  "protocolVersion": {
    object (Version)
  }
}
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

string (int64 format)

ZORUNLU: Bu isteğin epoch'tan beri geçen milisaniye cinsinden zaman damgası. Alıcı, bu zaman damgasının "şimdi" ± 60 saniyesi olduğunu doğrulamalıdır. Bu istek zaman damgası yeniden denemelerden sonra eş değerde değil.
userLocale
(deprecated)

string

KULLANIMDAN KALDIRILDI: İsteğe bağlı olarak, kısa çizgi ve ISO 3166-1 Alpha-2 ülke kodundan oluşan iki veya üç harfli ISO 639-2 Alfa 3 dil kodu (ör. "pt", "pt-BR", "fil" veya "fil-PH"). Yanıttaki userMessage alanlarını artırmak için bunu kullanın.
protocolVersion

object (Version)

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

Sürüm

Klasik a.b.c sürüm yapısının yapılandırılmış bir biçimi olan sürüm nesnesi. Aynı numaranın ana sürümlerinin uyumlu olması garanti edilir. Küçük çaplı ayarların ve düzeltmelerin sık sık ve önceden haber verilmeksizin değişebileceğini unutmayın. Entegre edici, aynı ana sürüme yönelik tüm istekleri desteklemelidir.

JSON gösterimi 
{
  "major": integer,
  "minor": integer,
  "revision": integer
}
Alanlar
major

integer

ZORUNLU: Ana sürüm. Bu, farklı sürümlere sahip uyumluluk isteklerinin uyumlu olacağı garanti edilmediği için işaretlenir.
minor

integer

ZORUNLU: Alt sürüm. Bu, önemli hata düzeltmelerinin olduğunu gösterir.
revision

integer

ZORUNLU: Alt sürüm. Bu, küçük hata düzeltmelerini belirtir.