Method: echo

Gibt den übergebenen clientMessage zurück.

Mit dieser Methode wird die grundlegende Konnektivität zwischen dem Zahlungsintegrator und Google getestet.

Diese Methode kann von Google mehrmals pro Minute mit gültigen oder ungültigen Parametern aufgerufen werden, um zu testen, ob Sicherheitsbeschränkungen richtig eingehalten werden. Google bezeichnet diese Methode auf Anweisung des Integrators und auf Anweisung von Google auch „ad hoc“. Google ruft diese Seite niemals schneller als einmal alle 10 Sekunden und nie öfter als 30 Mal in einem 15-Minuten-Fenster auf.

Beispiele für Tests zu Sicherheitseinschränkungen:

  • Testen Sie, um sicherzustellen, dass der Endpunkt des Zahlungsintegrators nicht mit schwachen Cipher Suites verhandelt.
  • Testen, um sicherzustellen, dass der Endpunkt des Zahlungsintegrators nur mit TLS 1.2 verhandelt
  • Testen Sie, ob der Endpunkt des Zahlungsintegrators HTTP nicht unterstützt.
  • Testen Sie, ob der Endpunkt des Zahlungsintegrators mindestens einen bekannten PGP-Signaturschlüssel verlangt.
  • Testen Sie, ob der Endpunkt des Zahlungsintegrators mehrere bekannte und unbekannte PGP-Schlüsselsignaturen unterstützt, sowohl abgelaufene als auch aktive.
  • Testen Sie, ob der Zahlungsintegrator nur das strikte JSON-Parsing unterstützt.

Wenn am Endpunkt bei der Verarbeitung der Anfrage ein Fehler auftritt, sollte der Antworttext von diesem Endpunkt den Typ ErrorResponse haben.

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://www.integratorhost.example.com/v1/echo

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
Felder
requestHeader

object (RequestHeader)

ERFORDERLICH: Gemeinsamer Header für alle Anfragen.
clientMessage

string

ERFORDERLICH: 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 (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
Felder
responseHeader

object (ResponseHeader)

ERFORDERLICH: Gemeinsamer Header für alle Antworten.
clientMessage

string

ERFORDERLICH: In der Anfrage enthaltene Nachricht.
serverMessage

string

OPTIONAL: Servernachricht, unabhängig von der clientMessage, die zurückgegeben wird.