clientMessage
adlı kişinin gittiğini hatırlatıyor.
Bu yöntemin amacı, ödeme entegratörü ile Google arasındaki temel bağlantıyı test etmektir.
Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan gelen yanıt
türünde olur.ErrorResponse
Bu yöntem bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Net bir açıklamaya sahip
, 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.ErrorResponse
Ö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://vgw.googleapis.com/secure-serving/gsp/v1/echo/:PIAID
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{
"requestHeader": {
object ( |
Alanlar | |
---|---|
requestHeader |
ZORUNLU: Tüm istekler için ortak başlık. |
clientMessage |
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 ( |
Alanlar | |
---|---|
responseHeader |
ZORUNLU: Tüm yanıtlar için ortak başlık. |
clientMessage |
ZORUNLU: İstekte mesaj alındı. |
serverMessage |
İSTEĞE BAĞLI: Yankılan |
RequestHeader
Sunucuya gönderilen tüm isteklerde tanımlanan başlık nesnesi.
JSON gösterimi |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
Alanlar | |
---|---|
requestId |
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 |
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 |
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 |
protocolVersion |
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 |
ZORUNLU: Ana sürüm. Bu, farklı sürümlere sahip uyumluluk isteklerinin uyumlu olacağı garanti edilmediği için işaretlenir. |
minor |
ZORUNLU: Alt sürüm. Bu, önemli hata düzeltmelerinin olduğunu gösterir. |
revision |
ZORUNLU: Alt sürüm. Bu, küçük hata düzeltmelerini belirtir. |