Changes for page 1. SearchTourPackages

Last modified by Giorgi Mdivnishvili on 2025/02/12 15:25

From version 11.1
edited by Giorgi Mdivnishvili
on 2023/12/15 12:22
Change comment: There is no comment for this version
To version 2.1
edited by Giorgi Mdivnishvili
on 2023/12/14 17:43
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -9,17 +9,23 @@
9 9  The initial method of the integration process is authorization. You will be provided with a test user username and password to generate the access token that you will need to pass in all the following methods.
10 10  
11 11  
12 -== Endpoint URL - [POST] ==
12 +== Endpoint URL - [GET] ==
13 13  
14 14  {{info}}
15 -[[https:~~/~~/online-api.kazunion.com/api/TourPackages/SearchTourPackages>>https://online-api.kazunion.com/api/TourPackages/SearchTourPackages]]
15 +[[http:~~/~~/online-api.kazunion.com/api/Catalogue/GetHotels>>http://online-api.kazunion.com/api/Catalogue/GetHotels]]
16 16  {{/info}}
17 17  
18 +
18 18  == Request Parameters ==
19 19  
20 20  (% class="box infomessage" %)
21 21  (((
22 -NoneĀ 
23 +
24 +
25 +|**Key**|**Value**|**Request URL**
26 +|CountryCode|AE|[[http:~~/~~/online-api.kazunion.com/api/Catalogue/GetHotels?countryCode=AE>>http://online-api.kazunion.com/api/Catalogue/GetHotels?countryCode=AE]]
27 +
28 +
23 23  )))
24 24  
25 25  
... ... @@ -26,62 +26,7 @@
26 26  == Request Body ==
27 27  
28 28  {{code language="Json"}}
29 -{
30 - "departureCountryCode": "string",
31 - "departureCityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
32 - "arrivalCountryCode": "string",
33 - "arrivalLocations": [
34 - {
35 - "type": "string",
36 - "parent": "string",
37 - "label": "string",
38 - "subLabel": "string",
39 - "value": "string",
40 - "tag": "string"
41 - }
42 - ],
43 - "checkInDate": "2023-12-14T13:43:54.766Z",
44 - "checkInDateTo": "2023-12-14T13:43:54.766Z",
45 - "checkOutDate": "2023-12-14T13:43:54.766Z",
46 - "stayDays": 0,
47 - "stayDaysTo": 0,
48 - "departureDate": "2023-12-14T13:43:54.766Z",
49 - "returnDate": "2023-12-14T13:43:54.766Z",
50 - "airlineCode": "string",
51 - "ticketType": "string",
52 - "directFlightsOnly": true,
53 - "longConnectTime": true,
54 - "adults": 0,
55 - "children": 0,
56 - "childrenAges": [
57 - 0
58 - ],
59 - "extendedSearch": true,
60 - "totalPriceFrom": 0,
61 - "totalPriceTo": 0,
62 - "recommended": true,
63 - "popular": true,
64 - "freeSale": true,
65 - "groupByHotel": true,
66 - "hotelCodes": [
67 - "string"
68 - ],
69 - "mealPlans": [
70 - "string"
71 - ],
72 - "hotelClasses": [
73 - "string"
74 - ],
75 - "hotelTypes": [
76 - "CityHotel"
77 - ],
78 - "hotelServices": [
79 - "HasAlcohol"
80 - ],
81 - "pagingId": "string",
82 - "pageNumber": 0,
83 - "pageRowCount": 0
84 -}
35 +none
85 85  {{/code}}
86 86  
87 87  
... ... @@ -88,179 +88,27 @@
88 88  == Response Body ==
89 89  
90 90  {{code language="json"}}
91 -{
92 - "error": true,
93 - "errorCode": "string",
94 - "errorDescription": "string",
95 - "userErrorDescription": "string",
96 - "packages": [
97 - {
98 - "cacheKey": "string",
99 - "id": "string",
100 - "priceCurrency": "string",
101 - "totalPrice": 0,
102 - "agentCommissionPercent": 0,
103 - "agentCommissionAmount": 0,
104 - "includedExtrasAmount": 0,
105 - "priceDifference": 0,
106 - "hotel": {
107 - "hotelPriceId": "string",
108 - "providerId": 0,
109 - "hotelName": "string",
110 - "hotelCode": "string",
111 - "nigths": 0,
112 - "mealPlan": "string",
113 - "hotelClass": "string",
114 - "availabilityType": "OnRequest",
115 - "availableRoomsCount": 0,
116 - "fewRooms": true,
117 - "roomCategoryCode": "string",
118 - "roomCategoryName": "string",
119 - "placementTypeName": "string",
120 - "placementDescription": "string",
121 - "checkInDate": "2023-12-14T13:47:13.396Z",
122 - "checkOutDate": "2023-12-14T13:47:13.396Z",
123 - "adults": 0,
124 - "children": 0,
125 - "districtUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
126 - "districtName": "string",
127 - "cityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
128 - "cityName": "string",
129 - "countryCode": "string",
130 - "countryName": "string",
131 - "hasAlcohol": true,
132 - "hasFreeWifi": true,
133 - "hasMetro": true,
134 - "hasPool": true,
135 - "hasMall": true,
136 - "cancellationPolicyDescription": "string",
137 - "cancellationPolicy": {
138 - "cancellationPolicyCode": "string",
139 - "noShowChargeValue": 0,
140 - "noShowChargeValueType": "string",
141 - "earlyDepartureChargeValue": 0,
142 - "earlyDepartureChargeValueType": "string",
143 - "conditions": [
144 - {
145 - "timeunits": 0,
146 - "timeunitType": "string",
147 - "timeOffsetTypeName": "string",
148 - "chargeValue": 0,
149 - "chargeValueType": "string"
150 - }
151 - ]
152 - }
153 - },
154 - "flight": {
155 - "id": "string",
156 - "departureDate": "2023-12-14T13:47:13.396Z",
157 - "returnDate": "2023-12-14T13:47:13.396Z",
158 - "departureTicketsLeft": 0,
159 - "returnTicketsLeft": 0,
160 - "departureAvailabilityType": "OnRequest",
161 - "returnAvailabilityType": "OnRequest",
162 - "isTwoWay": true,
163 - "departureSegments": [
164 - {
165 - "airlineCode": "string",
166 - "airlineName": "string",
167 - "flightCode": "string",
168 - "class": "string",
169 - "lugageWeight": 0,
170 - "handLugageWeight": 0,
171 - "departureFlightDate": "2023-12-14T13:47:13.396Z",
172 - "departureCountryName": "string",
173 - "departureCityName": "string",
174 - "departureAirportCode": "string",
175 - "departureAirportName": "string",
176 - "departureTerminalCode": "string",
177 - "arrivalFlightDate": "2023-12-14T13:47:13.396Z",
178 - "arrivalCountryName": "string",
179 - "arrivalCityName": "string",
180 - "arrivalAirportCode": "string",
181 - "arrivalAirportName": "string",
182 - "arrivalTerminalCode": "string",
183 - "flightDuration": "string",
184 - "baggages": [
185 - {
186 - "baggageCode": "string",
187 - "description": "string",
188 - "price": 0,
189 - "currency": "string",
190 - "included": true
191 - }
192 - ]
193 - }
194 - ],
195 - "returnSegments": [
196 - {
197 - "airlineCode": "string",
198 - "airlineName": "string",
199 - "flightCode": "string",
200 - "class": "string",
201 - "lugageWeight": 0,
202 - "handLugageWeight": 0,
203 - "departureFlightDate": "2023-12-14T13:47:13.396Z",
204 - "departureCountryName": "string",
205 - "departureCityName": "string",
206 - "departureAirportCode": "string",
207 - "departureAirportName": "string",
208 - "departureTerminalCode": "string",
209 - "arrivalFlightDate": "2023-12-14T13:47:13.396Z",
210 - "arrivalCountryName": "string",
211 - "arrivalCityName": "string",
212 - "arrivalAirportCode": "string",
213 - "arrivalAirportName": "string",
214 - "arrivalTerminalCode": "string",
215 - "flightDuration": "string",
216 - "baggages": [
217 - {
218 - "baggageCode": "string",
219 - "description": "string",
220 - "price": 0,
221 - "currency": "string",
222 - "included": true
223 - }
224 - ]
225 - }
226 - ]
227 - },
228 - "extraServices": [
229 - {
230 - "extraServiceCode": "string",
231 - "extraServiceTypeCode": "string",
232 - "isMandatory": 0,
233 - "extraServiceName": "string",
234 - "minimalServiceAmount": 0,
235 - "includedPriceCode": "string",
236 - "prices": [
237 - {
238 - "extraServicePriceCode": "string",
239 - "displayName": "string",
240 - "restrictionInfo": "string",
241 - "additionalInfo": "string",
242 - "price": 0,
243 - "extraPrice": 0,
244 - "currency": "string"
245 - }
246 - ]
247 - }
248 - ],
249 - "insurancePrice": {
250 - "name": "string",
251 - "price": 0,
252 - "priceSurcarge": 0,
253 - "actualStartDate": "2023-12-14T13:47:13.396Z",
254 - "actualEndDate": "2023-12-14T13:47:13.396Z",
255 - "optional": true,
256 - "includedInPackagePrice": true
257 - }
258 - }
259 - ],
260 - "pagingId": "string",
261 - "pageNumber": 0,
262 - "pageCount": 0
263 -}
42 +[
43 + {
44 + "hotelCode": "string",
45 + "hotelName": "string",
46 + "hotelClass": "string",
47 + "cityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
48 + "countryCode": "string",
49 + "countryName": "string",
50 + "districtUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
51 + "cityName": "string",
52 + "districtName": "string",
53 + "hotelType": "CityHotel",
54 + "latitude": "string",
55 + "longitude": "string",
56 + "hasAlcohol": true,
57 + "hasFreeWifi": true,
58 + "hasMetro": true,
59 + "hasPool": true,
60 + "hasMall": true
61 + }
62 +]
264 264  {{/code}}
265 265  
266 266  
... ... @@ -267,7 +267,42 @@
267 267  === example ===
268 268  
269 269  {{code language="Json"}}
270 -X
69 +{
70 + "hotelCode": "cfbca5b5-4090-4bcd-805a-463d83423b86",
71 + "hotelName": "Ramada Abu Dhabi Corniche",
72 + "hotelClass": "4",
73 + "cityUID": "28c794fe-3c7e-4da2-ba93-f24bd3d4730d",
74 + "countryCode": "AE",
75 + "districtUID": "ee402984-6d1d-4fcf-915d-f31b14fa8b0f",
76 + "cityName": "Abu Dhabi",
77 + "districtName": "Abu Dhabi",
78 + "hotelType": "CityHotel",
79 + "latitude": "24.503759",
80 + "longitude": "54.374577",
81 + "hasAlcohol": false,
82 + "hasFreeWifi": true,
83 + "hasMetro": false,
84 + "hasPool": true,
85 + "hasMall": false
86 + },
87 + {
88 + "hotelCode": "c64b6082-2337-4519-8c33-4bcdef76b16b",
89 + "hotelName": "Emirates Palace Mandarin Oriental, Abu Dhabi",
90 + "hotelClass": "5",
91 + "cityUID": "28c794fe-3c7e-4da2-ba93-f24bd3d4730d",
92 + "countryCode": "AE",
93 + "districtUID": "ee402984-6d1d-4fcf-915d-f31b14fa8b0f",
94 + "cityName": "Abu Dhabi",
95 + "districtName": "Abu Dhabi",
96 + "hotelType": "BeachHotel",
97 + "latitude": "24.461556",
98 + "longitude": "54.317404",
99 + "hasAlcohol": false,
100 + "hasFreeWifi": true,
101 + "hasMetro": false,
102 + "hasPool": true,
103 + "hasMall": false
104 + },
271 271  {{/code}}
272 272  
273 273  
... ... @@ -274,261 +274,36 @@
274 274  === Schema ===
275 275  
276 276  {{code language="none"}}
277 -SearchTourPackagesResponse{
278 -error boolean
279 -errorCode string
111 +[Hotel{
112 +hotelCode string
280 280  nullable: true
281 -errorDescription string
282 -nullable: true
283 -userErrorDescription string
284 -nullable: true
285 -packages [
286 -nullable: true
287 -TourPackage{
288 -cacheKey string
289 -nullable: true
290 -id string
291 -nullable: true
292 -priceCurrency string
293 -nullable: true
294 -totalPrice number($double)
295 -agentCommissionPercent number($double)
296 -agentCommissionAmount number($double)
297 -includedExtrasAmount number($double)
298 -priceDifference number($double)
299 -hotel PackageHotel{
300 -hotelPriceId string
301 -nullable: true
302 -providerId integer($int32)
303 303  hotelName string
304 304  nullable: true
305 -hotelCode string
306 -nullable: true
307 -nigths integer($int32)
308 -mealPlan string
309 -nullable: true
310 310  hotelClass string
311 311  nullable: true
312 -availabilityType RoomAvailabilityTypeEnum[...]
313 -availableRoomsCount integer($int32)
314 -fewRooms boolean
315 -roomCategoryCode string
118 +cityUID string($uuid)
316 316  nullable: true
317 -roomCategoryName string
120 +countryCode string
318 318  nullable: true
319 -placementTypeName string
122 +countryName string
320 320  nullable: true
321 -placementDescription string
322 -nullable: true
323 -checkInDate string($date-time)
324 -checkOutDate string($date-time)
325 -adults integer($int32)
326 -children integer($int32)
327 327  districtUID string($uuid)
328 328  nullable: true
329 -districtName string
330 -nullable: true
331 -cityUID string($uuid)
332 -nullable: true
333 333  cityName string
334 334  nullable: true
335 -countryCode string
128 +districtName string
336 336  nullable: true
337 -countryName string
130 +hotelType HotelTypeEnumstring
131 +Enum:
132 +[ CityHotel, BeachHotel, SecondLineBeach ]
133 +latitude string
338 338  nullable: true
135 +longitude string
136 +nullable: true
339 339  hasAlcohol boolean
340 340  hasFreeWifi boolean
341 341  hasMetro boolean
342 342  hasPool boolean
343 343  hasMall boolean
344 -cancellationPolicyDescription string
345 -nullable: true
346 -cancellationPolicy CancellationPolicyExchange{
347 -cancellationPolicyCode string
348 -nullable: true
349 -noShowChargeValue number($double)
350 -nullable: true
351 -noShowChargeValueType string
352 -nullable: true
353 -earlyDepartureChargeValue number($double)
354 -nullable: true
355 -earlyDepartureChargeValueType string
356 -nullable: true
357 -conditions [
358 -nullable: true
359 -CancellationPolicyConditionExchange{
360 -timeunits integer($int32)
361 -timeunitType string
362 -nullable: true
363 -timeOffsetTypeName string
364 -nullable: true
365 -chargeValue number($double)
366 -nullable: true
367 -chargeValueType string
368 -nullable: true
369 369  }]
370 -}
371 -}
372 -flight PackageFlight{
373 -id string
374 -nullable: true
375 -departureDate string($date-time)
376 -returnDate string($date-time)
377 -nullable: true
378 -departureTicketsLeft integer($int32)
379 -returnTicketsLeft integer($int32)
380 -departureAvailabilityType FlightAvailabilityTypestring
381 -Enum:
382 -[ OnRequest, FreeSale, FewPlaces, StopSale ]
383 -returnAvailabilityType FlightAvailabilityTypestring
384 -Enum:
385 -[ OnRequest, FreeSale, FewPlaces, StopSale ]
386 -isTwoWay boolean
387 -departureSegments [
388 -nullable: true
389 -FlightSegment{
390 -airlineCode string
391 -nullable: true
392 -airlineName string
393 -nullable: true
394 -flightCode string
395 -nullable: true
396 -class string
397 -nullable: true
398 -lugageWeight number($double)
399 -handLugageWeight number($double)
400 -departureFlightDate string($date-time)
401 -departureCountryName string
402 -nullable: true
403 -departureCityName string
404 -nullable: true
405 -departureAirportCode string
406 -nullable: true
407 -departureAirportName string
408 -nullable: true
409 -departureTerminalCode string
410 -nullable: true
411 -arrivalFlightDate string($date-time)
412 -arrivalCountryName string
413 -nullable: true
414 -arrivalCityName string
415 -nullable: true
416 -arrivalAirportCode string
417 -nullable: true
418 -arrivalAirportName string
419 -nullable: true
420 -arrivalTerminalCode string
421 -nullable: true
422 -flightDuration string
423 -nullable: true
424 -baggages [
425 -nullable: true
426 -Baggage{
427 -baggageCode string
428 -nullable: true
429 -description string
430 -nullable: true
431 -price number($double)
432 -currency string
433 -nullable: true
434 -included boolean
435 -}]
436 -}]
437 -returnSegments [
438 -nullable: true
439 -FlightSegment{
440 -airlineCode string
441 -nullable: true
442 -airlineName string
443 -nullable: true
444 -flightCode string
445 -nullable: true
446 -class string
447 -nullable: true
448 -lugageWeight number($double)
449 -handLugageWeight number($double)
450 -departureFlightDate string($date-time)
451 -departureCountryName string
452 -nullable: true
453 -departureCityName string
454 -nullable: true
455 -departureAirportCode string
456 -nullable: true
457 -departureAirportName string
458 -nullable: true
459 -departureTerminalCode string
460 -nullable: true
461 -arrivalFlightDate string($date-time)
462 -arrivalCountryName string
463 -nullable: true
464 -arrivalCityName string
465 -nullable: true
466 -arrivalAirportCode string
467 -nullable: true
468 -arrivalAirportName string
469 -nullable: true
470 -arrivalTerminalCode string
471 -nullable: true
472 -flightDuration string
473 -nullable: true
474 -baggages [
475 -nullable: true
476 -Baggage{
477 -baggageCode string
478 -nullable: true
479 -description string
480 -nullable: true
481 -price number($double)
482 -currency string
483 -nullable: true
484 -included boolean
485 -}]
486 -}]
487 -}
488 -extraServices [
489 -nullable: true
490 -HotelExtraServiceBase{
491 -extraServiceCode string
492 -nullable: true
493 -extraServiceTypeCode string
494 -nullable: true
495 -isMandatory integer($int32)
496 -extraServiceName string
497 -nullable: true
498 -minimalServiceAmount number($double)
499 -includedPriceCode string
500 -nullable: true
501 -prices [
502 -nullable: true
503 -HotelExtraServicePriceBase{
504 -extraServicePriceCode string
505 -nullable: true
506 -displayName string
507 -nullable: true
508 -restrictionInfo string
509 -nullable: true
510 -additionalInfo string
511 -nullable: true
512 -price number($double)
513 -extraPrice number($double)
514 -currency string
515 -nullable: true
516 -}]
517 -}]
518 -insurancePrice InsurancePrice{
519 -name string
520 -nullable: true
521 -price number($double)
522 -priceSurcarge number($double)
523 -actualStartDate string($date-time)
524 -actualEndDate string($date-time)
525 -optional boolean
526 -includedInPackagePrice boolean
527 -}
528 -}]
529 -pagingId string
530 -nullable: true
531 -pageNumber integer($int64)
532 -pageCount integer($int64)
533 -}
534 534  {{/code}}