Elle renvoie une chaîne envoyée par le client.
Si le point de terminaison rencontre une erreur lors du traitement de la requête, le corps de la réponse de ce point de terminaison doit être de type
.ErrorResponse
Voici un exemple de requête:
{
"requestHeader": {
"protocolVersion": {
"major": 2
},
"requestId": "G1MQ0YERJ0Q7LPM",
"requestTimestamp": {
"epochMillis": "1481899949606"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD"
},
"clientMessage": "Client echo message"
}
Voici un exemple de réponse positive:
{
"responseHeader": {
"responseTimestamp": {
"epochMillis":"1481899950236"
}
},
"clientMessage": "Client echo message",
"serverMessage": "Debug ID 12345"
}
Requête HTTP
POST https://www.integratorhost.example.com/v2/echo
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": { 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 |
OBLIGATOIRE: horodatage de cette requête. Le destinataire doit vérifier que ce code temporel est à ± 60 secondes de "now" et refuser la requête dans le cas contraire. Cet horodatage de requête n'est pas idempotent lors de nouvelles tentatives. |
protocolVersion |
OBLIGATOIRE: version de cette requête. |
paymentIntegratorAccountId |
OBLIGATOIRE: identifie un compte unique soumis à des contraintes contractuelles. |