یک رشته ارسال شده از مشتری را بازتاب می دهد.
اگر نقطه پایانی هنگام پردازش درخواست با خطا مواجه شود، پاسخ این نقطه پایانی از نوع
خواهد بود.ErrorResponse
اگر این روش یک HTTP 200 را برنگرداند، ممکن است پاسخهای این عبارت خالی باشد. بدنه پاسخ در شرایطی که میتوان از یک
با توضیح واضح برای کمک به مهاجم برای درک شناسه حساب یکپارچهساز پرداخت سایر ادغامکنندهها استفاده کرد، خالی است. در این شرایط، که یا کلید امضا مطابقت ندارد، شناسه یکپارچه پرداخت پیدا نشد، یا کلید رمزگذاری ناشناخته بود، این روش یک 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 | الزامی است : پیامی برای بازتاب در پاسخ. |
بدن پاسخگو
شی پاسخ برای روش اکو.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"responseHeader": {
object ( |
زمینه های | |
---|---|
responseHeader | مورد نیاز : هدر مشترک برای همه پاسخ ها. |
clientMessage | الزامی : پیام در درخواست دریافت شده است. |
serverMessage | اختیاری : پیام سرور، مستقل از |
RequestHeader
شی هدر که روی تمام درخواست های ارسال شده به سرور تعریف می شود.
نمایندگی JSON |
---|
{ "requestId": string, "requestTimestamp": { object ( |
زمینه های | |
---|---|
requestId | مورد نیاز : شناسه منحصر به فرد این درخواست. این رشته ای است که حداکثر طول آن 100 کاراکتر است و فقط شامل کاراکترهای "az"، "AZ"، "0-9"، ":"، "-"، و "_" است. |
requestTimestamp | الزامی : مهر زمانی این درخواست. گیرنده باید تأیید کند که این مُهر زمانی ± 60 ثانیه «اکنون» است و اگر اینطور نیست درخواست را رد کند. این مهر زمانی درخواست پس از تلاش مجدد بی تاثیر نیست. |
protocolVersion | مورد نیاز : نسخه این درخواست. |
paymentIntegratorAccountId | مورد نیاز : یک حساب منحصر به فرد با محدودیت های قراردادی را شناسایی می کند. |