Method: echo

Consente di ripetere l'eco del clientMessage che è stato passato.

Lo scopo di questo metodo è testare la connettività di base tra l'integratore dei pagamenti e Google.

Questo metodo può essere chiamato da Google più volte al minuto con parametri validi o non validi per verificare che i vincoli di sicurezza siano mantenuti correttamente. Google definisce questo metodo anche ad hoc anche in base alle indicazioni dell'integratore e di Google. Google non chiamerà mai questo metodo più velocemente di una volta ogni 10 secondi e mai più di 30 volte in un periodo di 15 minuti.

Esempi di test dei vincoli di sicurezza sono, a titolo esemplificativo:

  • Esegui test per assicurarti che l'endpoint dell'integratore dei pagamenti non effettui negoziazioni con suite di crittografia deboli.
  • Esegui un test per assicurarti che l'endpoint dell'integratore dei pagamenti non effettui negoziazioni diverse da TLS 1.2
  • Esegui un test per assicurarti che l'endpoint dell'integratore dei pagamenti non supporti HTTP.
  • Esegui un test per verificare che l'endpoint dell'integratore dei pagamenti richieda almeno una chiave di firma PGP nota.
  • Esegui test per verificare che l'endpoint dell'integratore dei pagamenti supporti più firme di chiavi PGP, note e sconosciute, scadute e attive.
  • Esegui un test per assicurarti che l'integratore dei pagamenti supporti solo l'analisi JSON rigida.

Se l'endpoint rileva un errore durante l'elaborazione della richiesta, il corpo della risposta da questo endpoint deve essere di tipo ErrorResponse.

Ecco un esempio di richiesta:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "ZWNobyB0cmFuc2FjdGlvbg",
    "requestTimestamp": "1481899949606"
  },
  "clientMessage": "client message"
}

Ecco un esempio di risposta:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "clientMessage": "client message",
  "serverMessage": "server message"
}

Richiesta HTTP

POST https://www.integratorhost.example.com/v1/echo

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
Campi
requestHeader

object (RequestHeader)

REQUIRED: intestazione comune per tutte le richieste.
clientMessage

string

REQUIRED: messaggio da richiamare nella risposta.

Corpo della risposta

Oggetto di risposta per il metodo echo.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
Campi
responseHeader

object (ResponseHeader)

REQUIRED: intestazione comune per tutte le risposte.
clientMessage

string

REQUIRED: messaggio ricevuto nella richiesta.
serverMessage

string

FACOLTATIVO: messaggio del server, indipendentemente dall'eco clientMessage.