Method: echo

클라이언트에서 전송된 문자열을 에코백합니다.

요청을 처리하는 동안 엔드포인트에서 오류가 발생하면 이 엔드포인트의 응답 본문은 ErrorResponse 유형이어야 합니다.

요청의 예는 다음과 같습니다.


{
  "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://www.integratorhost.example.com/v2/echo

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

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와는 무관한 서버 메시지입니다.

RequestHeader

서버로 전송되는 모든 요청에 정의된 헤더 객체입니다.

JSON 표현 
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
필드
requestId

string

필수: 이 요청의 고유 식별자입니다.

이 문자열은 최대 길이가 100자(영문 기준)이며 'a~z', 'A~Z', '0~9', ':', '-', '_' 문자만 포함합니다.
requestTimestamp

object (Timestamp)

필수: 이 요청의 타임스탬프입니다. 수신자는 이 타임스탬프가 '현재'의 ±60초인지 확인하고, 그렇지 않은 경우 요청을 거부해야 합니다. 이 요청 타임스탬프는 재시도 시 멱등성이 없습니다.
protocolVersion

object (Version)

필수: 이 요청의 버전입니다.
paymentIntegratorAccountId

string

필수: 계약 제약 조건이 있는 고유 계정을 식별합니다.