Send a ping request to our API servers to determine if service is available in the event of a suspected outage or ISP issue, or to obtain EAN's Unix server time when troubleshooting issues with signature authentication.

Request Formats
XML/REST URL: GET http://api.ean.com/ean-services/rs/hotel/v3/ping?
XML Parent Element: <PingRequest>


Request Parameters

The ping request does not have any required elements or parameters. You may optionally send the echo parameter as described below.

When omitting the echo parameter from XML, you must either send an empty PingRequest parent element or omit the &xml= request body parameter completely.



Base Parameters
Name Value Required Description
echo string no Send any string value. If successful, the same value will return in the response.


Response Content
Name Value Description
echo string Returns the same value sent in the request.
ServerInfo object Attributes:
serverTime: current time in 24 hour format, including GMT offset.
timestamp: the current UNIX time in seconds. When using signature authentication, use this value to synchronize your server's time with ours to help resolve authentication errors.
instance: internal server value.

Example XML Request:

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

Example XML Response:

<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>

Example REST Request:

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

Example JSON Response:

{
    "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"
        } 
    }
}