傳送 Ping 要求至我們的 API 伺服器即可判定是否可能發生中斷或 ISP 問題,或者可於針對簽章驗證問題進行疑難排解時取得 EAN 的 Unix 伺服器時間。

要求格式
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/ping?
XML 父項目: <PingRequest>



要求參數

Ping 要求沒有任何必要的元素或參數。您可以選擇以下述方式傳送 echo 參數。

如果省略 XML 的 echo 參數,您必須傳送空白的 PingRequest 父項元素或完全省略 &xml= 要求主體參數。



基本參數
名稱 必要 說明
echo 字串 no 傳送任何字串值。如果成功,系統就會在回傳中傳回相同的值。

回傳內容
名稱 說明
echo 字串 傳回在回傳中傳送的相同值。
ServerInfo 物件 屬性:
serverTime:目前時間 (24 小時格式,包括 GMT 位移)。
timestamp:目前以秒計的時間。使用簽章驗證時,使用此值即可將您的伺服器時間與我們的伺服器時間同步以解決驗證錯誤的問題。
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"
        } 
    }
}