Method: echo

• בקשת HTTP
• גוף הבקשה
  • ייצוג JSON
• גוף התשובה
  • ייצוג JSON

מחזיר הד ל-clientMessage שמועבר.

מטרת השיטה הזו היא לבדוק קישוריות בסיסית בין משלב התשלומים ל-Google.

Google עשויה להפעיל את השיטה הזו כמה פעמים בדקה, עם פרמטרים חוקיים או לא חוקיים, כדי לבדוק שאילוצי האבטחה נשמרים כראוי. Google גם קוראת לשיטה הזו אד-הוק לפי כיוון של מבצע השילוב וגם לפי הכיוון של Google. Google לעולם לא תתקשר למספר הזה מהר יותר מפעם אחת בכל 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": string }

שדות
requestHeader	object (RequestHeader) חובה: כותרת משותפת לכל הבקשות.
clientMessage	string חובה: הודעה שתזכיר את התשובה שלה.

גוף התגובה

אובייקט תגובה לשיטת ההד.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

ייצוג JSON
{ "responseHeader": { object (ResponseHeader) }, "clientMessage": string, "serverMessage": string }

שדות
responseHeader	object (ResponseHeader) חובה: כותרת נפוצה לכל התשובות.
clientMessage	string חובה: התקבלה הודעה בבקשה.
serverMessage	string אופציונלי: הודעת שרת, ללא קשר ל-clientMessage שההד.