Skip to Content

Wiki source code of 4. Hotel Search

Version 17.1 by Giorgi Mdivnishvili on 2024/02/29 10:31
Show last authors
1 {{box cssClass="floatinginfobox" title="**Contents**"}}
2
3
4 {{toc/}}
5 {{/box}}
6
7 = Method Description =
8
9
10 With the parameters provided in GetHotels and GetCities reponse, it’s avaible to search hotels with the desired parameters in Hotels Search.
11
12
13 endpoint : [[https:~~/~~/testapi.rustaronline.com/api/Hotels/Search>>url:https://testapi.rustaronline.com/api/Hotels/Search]]
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
33 "arrivalCities": [
34 {
35 "cityUID": "e1344ba0-5273-4fc1-b6c4-72446260f430"
36
37 }
38 ]
39 }
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 }
184 {{/code}}
185
186