向我们的 API 服务器发送 ping 请求,以确定出现疑似中断或 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 字符串 发送任意字符串值。如果成功,则会在回复中返回相同值。

回复内容
名称 说明
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"
        } 
    }
}