Gibt das übergebene clientMessage
zurück.
Mit dieser Methode wird die grundlegende Konnektivität zwischen dem Zahlungsintegrator und Google getestet.
Wenn am Endpunkt bei der Verarbeitung der Anfrage ein Fehler auftritt, hat dieser Endpunkt eine Antwort vom Typ
.ErrorResponse
Die Antworten auf diese Abfrage können leer sein, wenn diese Methode keinen HTTP 200-Fehler zurückgibt. Der Antworttext ist leer, wenn ein
mit einer eindeutigen Beschreibung verwendet werden könnte, um einem Angreifer zu helfen, die Konto-ID des Zahlungsintegrators anderer Integratoren zu verstehen. In Fällen, in denen der Signaturschlüssel nicht übereinstimmt, die Zahlungsintegrator-ID nicht gefunden oder der Verschlüsselungsschlüssel unbekannt war, gibt diese Methode einen HTTP 404-Fehler mit leerem Text zurück. Wenn die Anfragesignatur verifiziert werden konnte, werden im Antworttext zusätzliche Informationen zum Fehler zurückgegeben.ErrorResponse
Eine Beispielanfrage sieht so aus:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "ZWNobyB0cmFuc2FjdGlvbg",
"requestTimestamp": "1481899949606"
},
"clientMessage": "client message"
}
Eine Beispielantwort sieht so aus:
{
"responseHeader": {
"responseTimestamp": "1481900013178"
},
"clientMessage": "client message",
"serverMessage": "server message"
}
HTTP-Anfrage
POST https://vgw.googleapis.com/secure-serving/gsp/v1/echo/:PIAID
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"requestHeader": {
object ( |
Felder | |
---|---|
requestHeader |
ERFORDERLICH: Allgemeiner Header für alle Anfragen. |
clientMessage |
REQUIRED: Nachricht, die in der Antwort wiederholt werden soll. |
Antworttext
Antwortobjekt für die echo-Methode.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"responseHeader": {
object ( |
Felder | |
---|---|
responseHeader |
REQUIRED: Allgemeiner Header für alle Antworten. |
clientMessage |
REQUIRED: In der Anfrage erhaltene Nachricht. |
serverMessage |
OPTIONAL: Servernachricht, unabhängig vom |
RequestHeader
Header-Objekt, das für alle an den Server gesendeten Anfragen definiert wird.
JSON-Darstellung |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
Felder | |
---|---|
requestId |
REQUIRED: Die eindeutige ID der Anfrage. Dies ist ein String mit maximal 100 Zeichen, der nur die Zeichen „a–z“, „A–Z“, „0–9“, ":", „-“ und „_“ enthält. |
requestTimestamp |
REQUIRED: Zeitstempel dieser Anfrage in Millisekunden seit der Epoche. Der Empfänger sollte überprüfen, ob dieser Zeitstempel ± 60 Sekunden von „jetzt“ ist. Dieser Anfragezeitstempel ist bei Wiederholungen nicht idempotent. |
userLocale |
EINGESTELLT: Ein aus zwei oder drei Buchstaben bestehender ISO 639-2 Alpha 3-Sprachcode, optional gefolgt von einem Bindestrich und einem Ländercode gemäß ISO 3166-1 Alpha-2, z.B."pt", "pt-BR", "fil" oder "fil-PH". Verwenden Sie dies, um die |
protocolVersion |
REQUIRED: Die Version dieser Anfrage. |
Version
Versionsobjekt, das eine strukturierte Form der klassischen a.b.c
-Versionsstruktur ist. Für Hauptversionen derselben Nummer wird garantiert, dass sie kompatibel sind. Beachten Sie, dass kleinere und überarbeitete Versionen häufig und ohne Vorankündigung geändert werden können. Der Integrator muss alle Anfragen für dieselbe Hauptversion unterstützen.
JSON-Darstellung |
---|
{ "major": integer, "minor": integer, "revision": integer } |
Felder | |
---|---|
major |
ERFORDERLICH: Hauptversion. Dies ist für Kompatibilitätsanfragen mit unterschiedlichen Versionen gekennzeichnet, bei denen nicht garantiert wird, dass sie kompatibel sind. |
minor |
REQUIRED: Nebenversion. Dies weist auf erhebliche Fehlerkorrekturen hin. |
revision |
REQUIRED: Nebenversion. Dies weist auf kleinere Fehlerkorrekturen hin. |