Skip to Content

Changes for page 4. Hotel Search

Last modified by Giorgi Mdivnishvili on 2024/09/04 09:58
From version 4.1
edited by Giorgi Mdivnishvili
on 2023/11/28 17:36
Change comment: There is no comment for this version
To version 17.1
edited by Giorgi Mdivnishvili
on 2024/02/29 10:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Hotel Search
1 +4. Hotel Search
Content
... ... @@ -1,5 +1,12 @@
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}
1 1  
2 2  
4 +{{toc/}}
5 +{{/box}}
6 +
7 += Method Description =
8 +
9 +
3 3  With the parameters provided in GetHotels and GetCities reponse, it’s avaible to search hotels with the desired parameters in Hotels Search.
4 4  
5 5  
... ... @@ -7,29 +7,173 @@
7 7  
8 8  Method POST
9 9  
10 -**Request example:**
11 11  
18 +
19 +== **Request example:** ==
20 +
12 12  {{code language="Json"}}
13 13  {
14 - "MaxResultCount":50,
15 - "MaxHotelCount":10,
16 - "ContragentContactUID":"55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",
17 - "CheckInDate":"2023-12-25T00:00:00",
18 - "CheckOutDate":"2024-01-02T00:00:00",
19 - "Adults":1,
20 - "Children":2,
21 - "ChildrenAges":"5,10",
22 - "CountryMask":"AE",
23 -
23 + "MaxResultCount":2,
24 + "MaxHotelCount":2,
25 + "contragentContactUID": "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",
26 + "countryMask": "TR",
27 + "CheckInDate": "2024-05-06",
28 + "CheckOutDate": "2024-05-07",
29 + "Adults": 1,
30 + "Children": 0,
31 + "ChildrenAges": "",
32 +
24 24   "arrivalCities": [
25 25   {
26 - "cityUID": "f5185fa3-3f56-44ed-bf6b-80386a33caa2"
35 + "cityUID": "e1344ba0-5273-4fc1-b6c4-72446260f430"
27 27  
28 28   }
29 29   ]
30 -
31 31  }
40 +
32 32  {{/code}}
33 33  
34 34  
44 +(% class="table-bordered" %)
45 +(% class="info" %)|**Parameter**|**Value**|**Description**
46 +|** "MaxResultCount"**|2,|Maximum number of results to display
47 +|** "MaxHotelCount"**|2,|Maximum number of hotels to display results
48 +|** "contragentContactUID"**| "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",|A unique code assigned to each application user
49 +|** "countryMask"**| "TR",|Country code, which can be retrieved in [[Get Cities>>Get Cities]] method, in parameter [countrycode]
50 +|** "CheckInDate"**| "2024-05-06",|Check in date "YY-MM-DD"
51 +|** "CheckOutDate"**| "2024-05-07",|Check out date "YY-MM-DD"
52 +|** "Adults"**| 1,|number of Adults
53 +|** "Children"**| 0,|Number of children
54 +|** "ChildrenAges"**| "",|children ages, the must be separated with ","
55 +|** "cityUID"**| "e1344ba0-5273-4fc1-b6c4-72446260f430"|Code of the city, which is available in method [[Get Cities>>Get Cities]] in parameter [cityid]
35 35  
57 +== ==
58 +
59 +(% class="wikigeneratedid" %)
60 +In case there is need to display hotels in whole country, no mater cities, it's possible to remove "arrivalCities" parameter.
61 +
62 +
63 +== Response Example ==
64 +
65 +
66 +{{code language="json"}}
67 +{
68 + "result": [
69 + {
70 + "resultID": 1656436810005000001,
71 + "hotelID": 871186,
72 + "providerID": 5,
73 + "roomCategoryCode": "ECO",
74 + "roomCategoryName": "Economic Room",
75 + "mealPlanName": "BB",
76 + "placementType": 1,
77 + "placementTypeName": "1 Adult",
78 + "priceCode": "BASERATE BB ECO",
79 + "priceCurrency": "EUR",
80 + "priceCurrencySrc": "EUR",
81 + "availability": 3,
82 + "availableRoomsCount": 1,
83 + "totalSellPriceSrc": 40.70,
84 + "totalSellPrice": 40.70,
85 + "totalPriceSurcharge": 0.00,
86 + "cancellationPolicyDescription": "Cancellation Policy: Non refundable",
87 + "cancellationPolicy": {
88 + "noShowChargeValue": 100.00,
89 + "noShowChargeValueType": "%",
90 + "earlyDepartureChargeValue": 100.00,
91 + "earlyDepartureChargeValueType": "%",
92 + "conditions": [
93 + {
94 + "timeunits": 365,
95 + "timeunitType": "Day",
96 + "timeOffsetTypeName": "Before Arrival",
97 + "chargeValue": 100.00,
98 + "chargeValueType": "%"
99 + }
100 + ]
101 + },
102 + "searchId": 1656436810,
103 + "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
104 + "id": 1656436810005000001,
105 + "hotel": {
106 + "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
107 + "hotelName": "Istanbul Holiday Hotel",
108 + "hotelClass": "***",
109 + "cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430",
110 + "cityName": "Istanbul",
111 + "countryCode": "TR",
112 + "districtId": "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",
113 + "districtName": "Fatih",
114 + "note": ""
115 + },
116 + "adults": 1,
117 + "children": 0,
118 + "childrenAges": "",
119 + "childrenExeptInfants": 0,
120 + "checkInDate": "2024-05-06T00:00:00",
121 + "checkOutDate": "2024-05-07T00:00:00",
122 + "includedExtrasAmount": 0,
123 + "extraServices": []
124 + },
125 + {
126 + "resultID": 1656436810005000003,
127 + "hotelID": 871186,
128 + "providerID": 5,
129 + "roomCategoryCode": "STANDART-2",
130 + "roomCategoryName": "Standart Double or Twin Room",
131 + "mealPlanName": "BB",
132 + "placementType": 1,
133 + "placementTypeName": "1 Adult",
134 + "priceCode": "BASERATE BB STANDART",
135 + "priceCurrency": "EUR",
136 + "priceCurrencySrc": "EUR",
137 + "availability": 3,
138 + "availableRoomsCount": 1,
139 + "totalSellPriceSrc": 53.90,
140 + "totalSellPrice": 53.90,
141 + "totalPriceSurcharge": 0.00,
142 + "cancellationPolicyDescription": "Cancellation Policy: Non refundable",
143 + "cancellationPolicy": {
144 + "noShowChargeValue": 100.00,
145 + "noShowChargeValueType": "%",
146 + "earlyDepartureChargeValue": 100.00,
147 + "earlyDepartureChargeValueType": "%",
148 + "conditions": [
149 + {
150 + "timeunits": 365,
151 + "timeunitType": "Day",
152 + "timeOffsetTypeName": "Before Arrival",
153 + "chargeValue": 100.00,
154 + "chargeValueType": "%"
155 + }
156 + ]
157 + },
158 + "searchId": 1656436810,
159 + "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
160 + "id": 1656436810005000003,
161 + "hotel": {
162 + "hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
163 + "hotelName": "Istanbul Holiday Hotel",
164 + "hotelClass": "***",
165 + "cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430",
166 + "cityName": "Istanbul",
167 + "countryCode": "TR",
168 + "districtId": "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",
169 + "districtName": "Fatih",
170 + "note": ""
171 + },
172 + "adults": 1,
173 + "children": 0,
174 + "childrenAges": "",
175 + "childrenExeptInfants": 0,
176 + "checkInDate": "2024-05-06T00:00:00",
177 + "checkOutDate": "2024-05-07T00:00:00",
178 + "includedExtrasAmount": 0,
179 + "extraServices": []
180 + }
181 + ],
182 + "error": false
183 +}
184 +{{/code}}
185 +
186 +