CiirusXMLAdditionalFunctions15025 Web Service

CiirusXMLAdditionalFunctions15025

Click here for a complete list of operations.

GetGuestReviews

Returns a Guest reviews stored for the specified Property or all properties.
Note: This function caches responses for 1 minute.

Pass the following parameters:

APIUsername (String) *Required
APIPassword (String) *Required
PropertyID (Integer) *Required
Note: If 0 is passed, returns all reviews available to your API User.

Error Responses:

GetGuestReviews: Validation Error 1
GetGuestReviews: Please contact CiiRUS to learn more regarding this API functionality.
GetGuestReviews: Error - CS Relation could not be resolved.
GetGuestReviews: Error - You do not have access rights to this Property (1).
GetGuestReviews: Error - You do not have access rights to this Property (2).
GetGuestReviews: Error - Could not resolve property AverageStarRating.
GetGuestReviews: Error - Could not resolve query.
GetGuestReviews: Error - No Extras Configured for this Property.
GetGuestReviews: Error - Unknown Error

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /XMLadditionalfunctions15.025.asmx HTTP/1.1
Host: api.ciirus.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://xml.ciirus.com/GetGuestReviews"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetGuestReviews xmlns="http://xml.ciirus.com/">
      <APIUserName>string</APIUserName>
      <APIPassword>string</APIPassword>
      <PropertyID>int</PropertyID>
    </GetGuestReviews>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetGuestReviewsResponse xmlns="http://xml.ciirus.com/">
      <GetGuestReviewsResult>
        <AverageStarRating>decimal</AverageStarRating>
        <dsReviews>
          <xsd:schema>schema</xsd:schema>xml</dsReviews>
        <ErrorMsg>string</ErrorMsg>
      </GetGuestReviewsResult>
    </GetGuestReviewsResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /XMLadditionalfunctions15.025.asmx HTTP/1.1
Host: api.ciirus.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetGuestReviews xmlns="http://xml.ciirus.com/">
      <APIUserName>string</APIUserName>
      <APIPassword>string</APIPassword>
      <PropertyID>int</PropertyID>
    </GetGuestReviews>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetGuestReviewsResponse xmlns="http://xml.ciirus.com/">
      <GetGuestReviewsResult>
        <AverageStarRating>decimal</AverageStarRating>
        <dsReviews>
          <xsd:schema>schema</xsd:schema>xml</dsReviews>
        <ErrorMsg>string</ErrorMsg>
      </GetGuestReviewsResult>
    </GetGuestReviewsResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /XMLadditionalfunctions15.025.asmx/GetGuestReviews?APIUserName=string&APIPassword=string&PropertyID=string HTTP/1.1
Host: api.ciirus.com

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<sGuestReviews xmlns="http://xml.ciirus.com/">
  <AverageStarRating>decimal</AverageStarRating>
  <dsReviews>
    <schema xmlns="http://www.w3.org/2001/XMLSchema">schema</schema>xml</dsReviews>
  <ErrorMsg>string</ErrorMsg>
</sGuestReviews>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /XMLadditionalfunctions15.025.asmx/GetGuestReviews HTTP/1.1
Host: api.ciirus.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

APIUserName=string&APIPassword=string&PropertyID=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<sGuestReviews xmlns="http://xml.ciirus.com/">
  <AverageStarRating>decimal</AverageStarRating>
  <dsReviews>
    <schema xmlns="http://www.w3.org/2001/XMLSchema">schema</schema>xml</dsReviews>
  <ErrorMsg>string</ErrorMsg>
</sGuestReviews>

Parameter	Value
APIUserName:
APIPassword:
PropertyID: