מחזיר הד למחרוזת שנשלחה מהלקוח.
אם נקודת הקצה נתקלת בשגיאה במהלך עיבוד הבקשה, התשובה מנקודת הקצה הזו תהיה מסוג
.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 תווים והיא מכילה רק את התווים "a-z", "A-Z", "0-9", ":", "-" ו-"_". |
requestTimestamp |
חובה: חותמת הזמן של הבקשה. המקבל חייב לוודא שחותמת הזמן הזו היא ± 60 שניות של 'עכשיו' ולדחות את הבקשה אם היא לא נכונה. חותמת הזמן של הבקשה אינה מזהה ביחס לניסיונות החוזרים. |
protocolVersion |
חובה: הגרסה של הבקשה. |
paymentIntegratorAccountId |
חובה: זיהוי חשבון ייחודי עם מגבלות חוזיות. |