시스템 중단 또는 ISP 문제가 의심될 때 서비스 사용 가능 여부를 확인하려는 경우, 서명 인증 문제를 해결할 때 EAN의 Unix 서버를 받으려는 경우에는 당사의 API 서버에 Ping 요청을 보냅니다.

요청 형식
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/ping?
XML 상위 요소: <PingRequest>



요청 매개변수

Ping 요청에는 필수 요소 또는 요인이 없습니다. 선택 사항으로 아래 설명과 같이 echo 매개변수를 전송할 수도 있습니다.

XML에서 echo 매개변수를 생략할 때는 빈 PingRequest 상위 요소를 전송하거나 &xml= 요청 본문 매개변수를 완전히 생략해야 합니다.



기본 요인
이름 필수 설명
echo 문자열 필수 아님 문자열 값을 전송합니다. 성공하는 경우 동일한 값이 응답에 반환됩니다.

응답 컨텐츠
이름 설명
echo 문자열 요청에서 전송한 동일한 값을 반환합니다.
ServerInfo 개체 특성:
serverTime: 24시간 형식으로 된 현재 시간이며 표준시간대(GMT 오프셋)를 포함합니다.
timestamp: 현재 UNIX 시간(초)입니다. 서명 인증을 사용할 때 이 값을 사용하여 서버 시간을 당사의 시간과 동기화하면 인증 오류를 해결할 수 있습니다.
instance: 내부 서버 값입니다.

XML 요청 예:

http://api.ean.com/ean-services/rs/hotel/v3/ping?
cid=55505
&apiKey=xxx-yourOwnKey-xxx
&customerUserAgent=xxx
&customerIpAddress=xxx
&xml=
<PingRequest>
<echo>This message should be echoed back to you.</echo>
</PingRequest> 

XML 응답 예:

<ns2:PingResponse xmlns:ns2 = "http://v3.hotel.wsapi.ean.com/">
   <customerSessionId>0ABAA82B-CA7A-1913-1682-C3F78A9060AC</customerSessionId>
   <echo>This message should be echoed back to you.</echo>
   <ServerInfo
      serverTime = "18:58:58.092-0500"
      timestamp = "1311724738"
      instance = "43"/>
</ns2:PingResponse>

REST 요청 예:

http://api.ean.com/ean-services/rs/hotel/v3/ping?
cid=55505
&minorRev=x
&apiKey=xxx-yourOwnKey-xxx
&customerUserAgent=xxx
&customerIpAddress=xxx
&echo=This message should be echoed back to you.

JSON 응답 예:

{
    "PingResponse" : {
        "customerSessionId" : "0ABAA827-41DA-4913-1682-C9038B9066D3",
        "echo" : "This message should be echoed back to you.",
        "ServerInfo" : {
            "@serverTime" : "18:57:31.345-0500",
            "@timestamp" : "1311724651",
            "@instance" : "39"
        } 
    }
}