ors/holidaycheck-api

PHP parser for HolidayCheck XML api

v1.0.0 2016-12-19 10:10 UTC

Requires

• php: >=5.4.0
• ext-curl: *
• openlss/lib-array2xml: ^0.5.1

MIT

• ors

• api
• holidaycheck

README

This is a simple PHP parser for HolidayCheck XML api, that already has a predefined model clases.

www.HolidayCheck.com is a free travel information website. Community members and other users write and share hotel reviews and upload travel pictures and videos. This information helps other people plan and organize their holidays.

In order to use this API, you will need Partner Token from HolidayCheck, which will be provided to you once you have signed a contract with HC.

Dependencies

This parser uses curl to send API requests and openlss/lib-array2xml for converting XML to array.

Important: Ratings are in range from 0.0 to 6.0.

Basic Usage

First create an instance:

$hc = new \HC\HolidayCheck($partner_token);

Get detailed information about a hotel (using holiday check unique hotel id):

	$hotel = $hc->hotel(49415);

	// output:
	Array
  	(
	    [id] => 49415
	    [uuid] => 4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
	    [name] => Hotel Veniqui
	    [recommendation] => 100.0
	    [averageRating] => 4.5
	    [countReviews] => 11
	    [geoLocation] => Array
	      (
	        [latitude] => 41.77302721395887
	        [longitude] => 9.392623901367188
	      )
	  
	    [hcRateUrl] => https://secure.holidaycheck.com/wcf/hotelreview/rate/4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
	    [hcReviewsUrl] => http://www.holidaycheck.com/hr/4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
    	[hcUrl] => http://www.holidaycheck.com/hi/4e19fc5c-2279-36f0-b4ff-69fd37b3e7df
	)

A list of hotels

$hotels = $hc->hotels(array(), '', 10);

A list of hotel ratings:

$ratings = $hc->hotelRatings(16);

Array
(
    [averageRating] => Array
        (
            [couple] => 4.95
            [family] => 5.0
            [friends] => 5.5
            [overall] => 4.7
            [single] => 2.0
        )

    [foodRating] => Array
        (
            [couple] => 5.0
            [family] => 5.5
            [friends] => 5.8
            [overall] => 5.3
            [single] => 0.0
        )

    [hotelRating] => Array
        (
            [couple] => 5.26667
            [family] => 5.15
            [friends] => 5.8
            [overall] => 4.84286
            [single] => 2.0
        )

    [locationRating] => Array
        (
            [couple] => 4.4
            [family] => 4.3
            [friends] => 4.8
            [overall] => 4.51429
            [single] => 5.0
        )

    [recommendation] => Array
        (
            [couple] => 100.0
            [family] => 100.0
            [friends] => 100.0
            [overall] => 88.888885
            [single] => 0.0
        )

    [roomRating] => Array
        (
            [couple] => 4.66667
            [family] => 4.75
            [friends] => 5.3
            [overall] => 4.68571
            [single] => 4.0
        )

    [serviceRating] => Array
        (
            [couple] => 5.5
            [family] => 5.55
            [friends] => 5.7
            [overall] => 5.32857
            [single] => 4.0
        )

    [sportRating] => Array
        (
            [couple] => 4.16667
            [family] => 4.75
            [friends] => 5.8
            [overall] => 4.63333
            [single] => 0.0
        )

)

A list of hotel reviews:

$ratings = $hc->hotelReviews(16, array(), false, 'entryDate', 10);	

A single review (using holiday check unique hotel review id):

	$review = $hc->hotelReview(2159596);
  
  	// output
  	Array
	(
	    [age] => 31-35
	    [firstName] => Tobias
	    [hcSourceUrl] => https://www.holidaycheck.de/hrd/1aa4c4ad-f9ea-3367-a163-8a3a6884d450/57b4a3e9-0384-3150-b1ef-4ec5dba12312
	    [hcUrl] => http://www.holidaycheck.com/hr/1aa4c4ad-f9ea-3367-a163-8a3a6884d450/-/review/57b4a3e9-0384-3150-b1ef-4ec5dba12312
	    [hotelId] => 70434
	    [hotelName] => Dana Beach Resort
	    [id] => 2159596
	    [language] => en
	    [originalLanguage] => de
	    [ratingFood] => 5.3
	    [ratingHotel] => 5.7
	    [ratingLocation] => 5.3
	    [ratingRoom] => 4.5
	    [ratingService] => 5.3
	    [ratingSport] => 5.0
	    [text] => The six block can not recommend the first floor, since the sounds of the departing Fleugzeuge (3.15
	    [textHotel] => 
	    [title] => Not the quietest Hotel
	    [traveledWith] => single
	    [travelReason] => beach
	    [uuid] => 57b4a3e9-0384-3150-b1ef-4ec5dba12312
	)