Method: echo

Visualizza l'eco del clientMessage trasmesso.

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 vengano mantenuti correttamente. Google definisce questo metodo anche ad hoc, secondo la direzione dell'integratore e di Google. Google non effettuerà mai chiamate più veloci di una volta ogni 10 secondi e mai più di 30 volte in un lasso di tempo di 15 minuti.

Di seguito sono riportati, a titolo esemplificativo, alcuni test dei vincoli di sicurezza:

  • Testa per assicurarti che l'endpoint dell'integratore dei pagamenti non negozi i pacchetti di crittografia deboli.
  • Test per garantire che l'endpoint dell'integratore dei pagamenti non negozia solo per TLS 1.2
  • Esegui dei test per assicurarti che l'endpoint dell'integratore dei pagamenti non supporti HTTP.
  • Testa per assicurarti che l'endpoint dell'integratore dei pagamenti richieda almeno una chiave di firma PGP nota.
  • Testa per assicurarti che l'endpoint dell'integratore dei pagamenti supporti più firme di chiavi PGP, sia note che sconosciute, sia scadute che attive.
  • Testa per garantire che l'integratore dei pagamenti supporti solo l'analisi JSON rigorosa.

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

Una richiesta di esempio ha il seguente aspetto:


{
  "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 di clientMessage.