Method: echo

Эхо возвращает строку, отправленную от клиента.

Если конечная точка обнаружит ошибку при обработке запроса, ответ от этой конечной точки будет иметь тип ErrorResponse .

Ответы на этот запрос могут быть пустыми, если этот метод не возвращает HTTP 200. Тело ответа пусто в ситуациях, когда ErrorResponse с четким описанием может использоваться, чтобы помочь злоумышленнику понять идентификатор учетной записи интегратора платежей других интеграторов. В таких ситуациях, когда ключ подписи не совпадает, идентификатор интегратора платежей не найден или ключ шифрования неизвестен, этот метод вернет HTTP 404 с пустым телом. Если подпись запроса может быть проверена, в теле ответа будет возвращена дополнительная информация об ошибке.

Пример запроса выглядит так:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 2
    },
    "requestId": "G1MQ0YERJ0Q7LPM",
    "requestTimestamp": {
      "epochMillis": "1481899949606"
    },
    "paymentIntegratorAccountId": "InvisiCashUSA_USD"
  },
  "clientMessage": "Client echo message"
}

Пример успешного ответа выглядит так:


{
  "responseHeader": {
    "responseTimestamp": {
      "epochMillis":"1481899950236"
    }
  },
  "clientMessage": "Client echo message",
  "serverMessage": "Debug ID 12345"
}

HTTP-запрос

POST https://vgw.googleapis.com/secure-serving/gsp/v2/echo/ :PIAID

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
Поля
requestHeader

object ( RequestHeader )

ОБЯЗАТЕЛЬНО : общий заголовок для всех запросов.

clientMessage

string

ОБЯЗАТЕЛЬНО : сообщение для отражения в ответе.

Тело ответа

Объект ответа для метода echo.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
Поля
responseHeader

object ( ResponseHeader )

ОБЯЗАТЕЛЬНО : общий заголовок для всех ответов.

clientMessage

string

ОБЯЗАТЕЛЬНО : сообщение, полученное в запросе.

serverMessage

string

НЕОБЯЗАТЕЛЬНО : сообщение сервера, независимо от отображаемого clientMessage .

Заголовок запроса

Объект заголовка, который определяется для всех запросов, отправляемых на сервер.

JSON-представление
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
Поля
requestId

string

ОБЯЗАТЕЛЬНО : уникальный идентификатор этого запроса.

Это строка максимальной длиной 100 символов, содержащая только символы «az», «AZ», «0-9», «:», «-» и «_».

requestTimestamp

object ( Timestamp )

ОБЯЗАТЕЛЬНО : временная метка этого запроса. Получатель должен убедиться, что эта временная метка составляет ± 60 с от «сейчас», и отклонить запрос, если это не так. Эта временная метка запроса не является идемпотентной при повторных попытках.

protocolVersion

object ( Version )

ОБЯЗАТЕЛЬНО : версия этого запроса.

paymentIntegratorAccountId

string

ОБЯЗАТЕЛЬНО : идентифицирует уникальную учетную запись с договорными ограничениями.