Changes for page 4. Hotel Search

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Title

...	...	@@ -1,1 +1,1 @@
1		-4. Hotel Search
	1	+Hotel Search

Content

...	...	@@ -1,245 +2,30 @@
1		-{{box cssClass="floatinginfobox" title="**Contents**"}}
2	2
3	3
4		-{{toc/}}
5		-{{/box}}
6		-
7		-= Method Description =
8		-
9		-
10	10	With the parameters provided in GetHotels and GetCities reponse, it’s avaible to search hotels with the desired parameters in Hotels Search.
11	11
12	12
13		-endpoint : [[https:~~/~~/testapi.rustaronline.com/api/Hotels/Search>>url:https://testapi.rustaronline.com/api/Hotels/Search]]
14	14
15		-Method POST
16		-
17		-
18		-
19		-== **Request example:** ==
20		-
21		-{{code language="Json"}}
22		-{
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		-
	7	+Request example:{{code language="Json"}}{
	8	+ "MaxResultCount":50, <<< max result count in response
	9	+ "MaxHotelCount":10, <<< max hotel count with the cheapest to expensive
	10	+ "ProviderIds":[5], <<< Dynamic channel, which cheeks prices during search, if you change it to 13 request will be immediate, but prices wont be the latest and cheapest.
	11	+ "ContragentContactUID":"55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",
	12	+ "CheckInDate":"2023-12-25T00:00:00",
	13	+ "CheckOutDate":"2024-01-02T00:00:00",
	14	+ "Adults":1,
	15	+ "Children":0,
	16	+ "ChildrenAges":"", in case of several children, "5,10" numbers must be separated by comma
	17	+ "CountryMask":"AE", << country code
	18	+
33	33	"arrivalCities": [
34	34	{
35		- "cityUID": "e1344ba0-5273-4fc1-b6c4-72446260f430"
	21	+ "cityUID": "f5185fa3-3f56-44ed-bf6b-80386a33caa2" << city UID where we are searching hotels
36	36
37	37	}
38	38	]
39		-}
40	40
41		-{{/code}}
42		-
43		-
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]
56		-
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	183	}
184	184	{{/code}}
185	185
186	186
187		-
188		-(% class="table-bordered" %)
189		-(% class="info" %)|**Parameter**|**value**|**Description**
190		-|**{**| |
191		-|** "resultID"**| 1656436810005000001,|Unique ID of the Result
192		-|** "hotelID"**| 871186,|Unique ID of the hotel
193		-|** "providerID"**| 5,|provider id - (system internal)
194		-|** "roomCategoryCode"**| "ECO",|Special code for Room Category type
195		-|** "roomCategoryName"**| "Economic Room",|Name of the Room Category Type - definition of the ** "roomCategoryCode"**
196		-|** "mealPlanName"**| "BB",|Meal Plan code
197		-|** "placementType"**| 1,|Placement type code - in this case  1 means  single
198		-|** "placementTypeName"**| "1 Adult",|Placement type name - definition of the ** "placementType"**
199		-|** "priceCode"**| "BASERATE BB ECO",|price code for the current option
200		-|** "priceCurrency"**| "EUR",|
201		-|** "priceCurrencySrc"**| "EUR",|
202		-|** "availability"**| 3,|Availability
203		-|** "availableRoomsCount"**| 1,|Number of available rooms for the current type of options
204		-|** "totalSellPriceSrc"**| 40.70,|
205		-|** "totalSellPrice"**| 40.70,|
206		-|** "totalPriceSurcharge"**| 0.00,|
207		-|** "cancellationPolicyDescription"**| "Cancellation Policy  Non refundable",|TEXT DESCRIPTION OF THE CANCELLATION POLICY
208		-|** "cancellationPolicy"**| {|
209		-|** "noShowChargeValue"**| 100.00,|
210		-|** "noShowChargeValueType"**| "%",|
211		-|** "earlyDepartureChargeValue"**| 100.00,|
212		-|** "earlyDepartureChargeValueType"**| "%",|
213		-|** "conditions"**| [|
214		-|** {**| |
215		-|** "timeunits"**| 365,|
216		-|** "timeunitType"**| "Day",|
217		-|** "timeOffsetTypeName"**| "Before Arrival",|
218		-|** "chargeValue"**| 100.00,|
219		-|** "chargeValueType"**| "%"|
220		-|** }**| |
221		-|** ]**| |
222		-|** },**| |
223		-|** "searchId"**| 1656436810,|search id of the hotel
224		-|** "hotelCode"**| "10b7bc34-2a03-495e-94bc-1092b07823f7",|Unique ID of the Hotel. Full List of the hotels is available in [[Get Hotels>>Get Hotels]] method
225		-|** "id"**| 1656436810005000001,|
226		-|** "hotel"**| {|
227		-|** "hotelCode"**| "10b7bc34-2a03-495e-94bc-1092b07823f7",|Unique ID of the Hotel. Full List of the hotels is available in [[Get Hotels>>Get Hotels]] method
228		-|** "hotelName"**| "Istanbul Holiday Hotel",|Full name of the Hotel
229		-|** "hotelClass"**| "~*~**",|Hotel Class in Stars
230		-|** "cityId"**| "e1344ba0-5273-4fc1-b6c4-72446260f430",|Code of the city where  hotel is located, which is available in method [[Get Cities>>Get Cities]] in parameter [cityid]
231		-|** "cityName"**| "Istanbul",|Full Name of the City
232		-|** "countryCode"**| "TR",|Country code, which can be retrieved in [[Get Cities>>Get Cities]] method, in parameter [countrycode]
233		-|** "districtId"**| "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",|District unique code, where hotel is located.
234		-|** "districtName"**| "Fatih",|Full name of the District
235		-|** "note"**| ""|Hotel note - this is optional
236		-|** },**| |
237		-|** "adults"**| 1,|Number of the adults
238		-|** "children"**| 0,|Number of the children
239		-|** "childrenAges"**| "",|in case of children, here will be their ages
240		-|** "childrenExeptInfants"**| 0,|
241		-|** "checkInDate"**| "2024-05-06T00000",|date of the check in
242		-|** "checkOutDate"**| "2024-05-07T00000",|date of the check out
243		-|** "includedExtrasAmount"**| 0,|
244		-|** "extraServices"**| []|
245		-|** },**| |
	30	+