Elle renvoie le clientMessage
transmis.
L'objectif de cette méthode est de tester la connectivité de base entre l'intégrateur de paiements et Google.
Si le point de terminaison rencontre une erreur lors du traitement de la requête, la réponse de ce point de terminaison sera de type
.ErrorResponse
Les réponses à cette requête peuvent être vides si cette méthode ne renvoie pas de code HTTP 200. Le corps de la réponse est vide dans les cas où un
avec une description claire pourrait être utilisé pour aider un pirate informatique à comprendre l'identifiant de compte d'intégrateur de paiement d'autres intégrateurs. Dans les cas où la clé de signature ne correspond pas, que l'identifiant de l'intégrateur de paiement est introuvable ou que la clé de chiffrement est inconnue, cette méthode renvoie une réponse HTTP 404 avec un corps vide. Si la signature de la requête a pu être vérifiée, des informations supplémentaires sur l'erreur sont renvoyées dans le corps de la réponse.ErrorResponse
Voici un exemple de requête:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "ZWNobyB0cmFuc2FjdGlvbg",
"requestTimestamp": "1481899949606"
},
"clientMessage": "client message"
}
Voici un exemple de réponse:
{
"responseHeader": {
"responseTimestamp": "1481900013178"
},
"clientMessage": "client message",
"serverMessage": "server message"
}
Requête HTTP
POST https://vgw.googleapis.com/secure-serving/gsp/v1/echo/:PIAID
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"requestHeader": {
object ( |
Champs | |
---|---|
requestHeader |
OBLIGATOIRE: en-tête commun pour toutes les requêtes. |
clientMessage |
OBLIGATOIRE: message à renvoyer dans la réponse. |
Corps de la réponse
Objet réponse pour la méthode echo.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{
"responseHeader": {
object ( |
Champs | |
---|---|
responseHeader |
OBLIGATOIRE: en-tête commun pour toutes les réponses. |
clientMessage |
OBLIGATOIRE: message reçu dans la requête. |
serverMessage |
FACULTATIF: message du serveur, indépendant du |
RequestHeader
Objet d'en-tête qui est défini sur toutes les requêtes envoyées au serveur.
Représentation JSON |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
Champs | |
---|---|
requestId |
OBLIGATOIRE: Identifiant unique de cette requête. Il s'agit d'une chaîne d'une longueur maximale de 100 caractères, qui ne contient que les caractères "a-z", "A-Z", "0-9", ":", "-" et "_". |
requestTimestamp |
REQUIRED: horodatage de cette requête représenté en millisecondes depuis l'epoch. Le récepteur doit vérifier que ce code temporel correspond à environ 60 secondes de "now" (maintenant). Cet horodatage de requête n'est pas idempotent lors de nouvelles tentatives. |
userLocale |
OBSOLÈTE: code de langue ISO 639-2 Alpha 3 à deux ou trois lettres suivi éventuellement d'un tiret et du code pays ISO 3166-1 Alpha-2 (par exemple, "pt", "pt-BR", "fil" ou "fil-PH"). Utilisez-le pour faciliter le fonctionnement des champs |
protocolVersion |
OBLIGATOIRE: version de cette requête. |
Version
Un objet Version, qui est une forme structurée de la structure de version a.b.c
classique La compatibilité des versions majeures du même nombre est garantie. Notez que les modifications mineures et révisions peuvent être fréquemment modifiées sans préavis. L'intégrateur doit accepter toutes les requêtes liées à la même version majeure.
Représentation JSON |
---|
{ "major": integer, "minor": integer, "revision": integer } |
Champs | |
---|---|
major |
OBLIGATOIRE: version majeure. Cette option n'est pas garantie pour les demandes de compatibilité avec différentes versions. |
minor |
OBLIGATOIRE: version mineure. Cela indique des corrections de bugs importantes. |
revision |
OBLIGATOIRE: version mineure. Cela indique des corrections de bugs mineurs. |