Skip to Content

Changes for page 4. Hotel Search

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

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -4. Hotel Search
1 +Hotel Search
Content
... ... @@ -1,186 +2,25 @@
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
7 +Request example:
16 16  
9 +>{ "MaxResultCount":50,  <<< max result count in response "MaxHotelCount":10, <<< max hotel count with the cheapest to expensive "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. "ContragentContactUID":"55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e", "CheckInDate":"2023-12-25T00:00:00", "CheckOutDate":"2024-01-02T00:00:00", "Adults":1, "Children":0, "ChildrenAges":"", in case of several children, "5,10" numbers must be separated by comma "CountryMask":"AE",  <<  country code
10 +(((
17 17  
12 + "arrivalCities": [
18 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 34   {
35 - "cityUID": "e1344ba0-5273-4fc1-b6c4-72446260f430"
36 -
37 - }
38 - ]
39 -}
40 40  
41 -{{/code}}
16 + "cityUID": "f5185fa3-3f56-44ed-bf6b-80386a33caa2" << city UID where we are searching hotels
42 42  
43 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]
19 + }
56 56  
57 -== ==
21 + ]
58 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 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 -{{/code}}
185 -
186 -
25 +)))