clientMessage
ارسال شده را بازتاب می دهد.
هدف از این روش آزمایش اتصال اولیه بین یکپارچهساز پرداخت و گوگل است.
این روش ممکن است توسط Google چندین بار در دقیقه با پارامترهای معتبر یا نامعتبر فراخوانی شود تا بررسی شود که محدودیتهای امنیتی به درستی نگهداری میشوند. گوگل همچنین این روش را ad-hoc در جهت ادغام کننده و همچنین در جهت گوگل می نامد. گوگل هرگز سریعتر از هر 10 ثانیه یک بار و هرگز بیش از 30 بار در یک پنجره 15 دقیقه ای این تماس را نخواهد داد.
نمونه هایی از تست های محدودیت امنیتی (اما نه محدود به):
- تست کنید تا مطمئن شوید نقطه پایانی یکپارچهساز پرداخت با مجموعههای رمز ضعیف مذاکره نمیکند.
- تست کنید تا مطمئن شوید نقطه پایانی یکپارچهساز پرداخت با چیزی جز TLS 1.2 مذاکره نمیکند
- تست کنید تا مطمئن شوید نقطه پایانی یکپارچهساز پرداخت از HTTP پشتیبانی نمیکند.
- تست کنید تا مطمئن شوید نقطه پایانی یکپارچهکننده پرداخت حداقل یک کلید امضای شناخته شده PGP را الزامی میکند.
- تست کنید تا مطمئن شوید نقطه پایانی یکپارچهساز پرداخت از چندین امضای کلید PGP، چه شناخته شده و چه ناشناخته، منقضی شده و فعال پشتیبانی میکند.
- تست کنید تا مطمئن شوید که یکپارچهکننده پرداخت فقط از تجزیه سخت JSON پشتیبانی میکند.
اگر نقطه پایانی هنگام پردازش درخواست با خطا مواجه شود، بدنه پاسخ از این نقطه پایانی باید از نوع
باشد.ErrorResponse
یک نمونه درخواست به نظر می رسد:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "ZWNobyB0cmFuc2FjdGlvbg",
"requestTimestamp": "1481899949606"
},
"clientMessage": "client message"
}
یک نمونه پاسخ به نظر می رسد:
{
"responseHeader": {
"responseTimestamp": "1481900013178"
},
"clientMessage": "client message",
"serverMessage": "server message"
}
درخواست HTTP
POST https://www.integratorhost.example.com/v1/echo
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"requestHeader": {
object ( |
زمینه های | |
---|---|
requestHeader | مورد نیاز : هدر مشترک برای همه درخواست ها. |
clientMessage | الزامی است : پیامی برای بازتاب در پاسخ. |
بدن پاسخگو
شی پاسخ برای روش اکو.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"responseHeader": {
object ( |
زمینه های | |
---|---|
responseHeader | مورد نیاز : هدر مشترک برای همه پاسخ ها. |
clientMessage | الزامی : پیام در درخواست دریافت شده است. |
serverMessage | اختیاری : پیام سرور، مستقل از |
RequestHeader
شی هدر که روی تمام درخواست های ارسال شده به سرور تعریف می شود.
نمایندگی JSON |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
زمینه های | |
---|---|
requestId | مورد نیاز : شناسه منحصر به فرد این درخواست. این رشته ای است که حداکثر طول آن 100 کاراکتر است و فقط شامل کاراکترهای "az"، "AZ"، "0-9"، ":"، "-"، و "_" است. |
requestTimestamp | الزامی است : مهر زمانی این درخواست به عنوان میلی ثانیه از آن دوره نشان داده شده است. گیرنده باید تأیید کند که این مُهر زمانی ± 60 ثانیه «اکنون» است. این مهر زمانی درخواست پس از تلاش مجدد بی تاثیر نیست. |
userLocale | منسوخ شده : کد زبان ISO 639-2 آلفا 3 دو یا سه حرفی که به صورت اختیاری با خط فاصله و کد کشور ISO 3166-1 آلفا-2، به عنوان مثال، «pt-BR»، «fil» یا 'fil-PH'. از این برای کمک به هدایت فیلدهای |
protocolVersion | مورد نیاز : نسخه این درخواست. |
نسخه
شئ نسخه که شکلی ساختار یافته از ساختار نسخه کلاسیک abc
است. نسخههای اصلی همین تعداد تضمین میشوند که سازگار باشند. توجه داشته باشید که اصلاحات جزئی و جزئی می توانند اغلب و بدون اطلاع قبلی تغییر کنند. یکپارچه کننده باید از همه درخواست ها برای یک نسخه اصلی پشتیبانی کند.
نمایندگی JSON |
---|
{ "major": integer, "minor": integer, "revision": integer } |
زمینه های | |
---|---|
major | مورد نیاز : نسخه اصلی. این برای درخواستهای سازگاری با نسخههای مختلف علامتگذاری شده است و تضمین نمیشود که سازگار باشند. |
minor | مورد نیاز : نسخه کوچک. این نشان دهنده رفع اشکال قابل توجه است. |
revision | مورد نیاز : نسخه کوچک. این نشان دهنده رفع اشکال جزئی است. |