Changes for page 1. SearchTourPackages

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

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

Summary

Details

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