Changes for page 2. GetOtherFlights

Last modified by Giorgi Mdivnishvili on 2024/04/11 17:06

From version 2.1
edited by Giorgi Mdivnishvili
on 2023/12/18 18:02
Change comment: There is no comment for this version
To version 15.1
edited by Giorgi Mdivnishvili
on 2024/04/11 17:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -GetOtherFlights
1 +2. GetOtherFlights
Content
... ... @@ -6,13 +6,22 @@
6 6  
7 7  = Method Description =
8 8  
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.
9 +After searching available tour packages according to your preferences, it's possible to choose alternate flight options. with this method it's possible to in same dates find alternative flights options.
10 10  
11 +The system enables users to initiate a detailed evaluation workflow for the selected package. This evaluation includes:
11 11  
13 +1. **Data Retrieval**: Automated fetching of extensive details related to the selected package, ensuring a complete dataset is available for user review.
14 +1. **Price Recalculation**: Implementation of dynamic pricing algorithms to recalculate the cost of the package in real-time, considering current availability, user preferences, and potential discounts.
15 +1. **Variant Exploration**: Activation of mechanisms to navigate and assess alternative package variations, offering users a breadth of options based on predefined criteria such as duration, included amenities, and price points.
16 +1. **Condition Assessment**: Provision of a detailed parsing and presentation layer for the terms and conditions associated with the package, enabling users to programmatically understand obligations, benefits, and limitations.
17 +
18 +This functionality is designed to support an informed decision-making process by providing a comprehensive, algorithm-driven analysis of each package from a technical and user-centric standpoint.
19 +
20 +
12 12  == Endpoint URL - [POST] ==
13 13  
14 14  {{info}}
15 -[[https:~~/~~/online-api.kazunion.com/api/TourPackages/SearchTourPackages>>https://online-api.kazunion.com/api/TourPackages/SearchTourPackages]]
24 +[[https:~~/~~/integration.kazunion.com/api/TourPackages/GetOtherFlights>>https://integration.kazunion.com/api/TourPackages/GetOtherFlights]]
16 16  {{/info}}
17 17  
18 18  == Request Parameters ==
... ... @@ -27,60 +27,168 @@
27 27  
28 28  {{code language="Json"}}
29 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
39 + "package": {
40 + "id": "string",
41 + "priceCurrency": "string",
42 + "totalPrice": 0,
43 + "agentCommissionPercent": 0,
44 + "agentCommissionAmount": 0,
45 + "includedExtrasAmount": 0,
46 + "priceDifference": 0,
47 + "hotel": {
48 + "hotelPriceId": "string",
49 + "providerId": 0,
50 + "hotelName": "string",
51 + "hotelCode": "string",
52 + "nigths": 0,
53 + "mealPlan": "string",
54 + "hotelClass": "string",
55 + "availabilityType": "OnRequest",
56 + "availableRoomsCount": 0,
57 + "fewRooms": true,
58 + "roomCategoryCode": "string",
59 + "roomCategoryName": "string",
60 + "placementTypeName": "string",
61 + "placementDescription": "string",
62 + "checkInDate": "2023-12-18T14:03:07.553Z",
63 + "checkOutDate": "2023-12-18T14:03:07.553Z",
64 + "adults": 0,
65 + "children": 0,
66 + "districtUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
67 + "districtName": "string",
68 + "cityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
69 + "cityName": "string",
70 + "countryCode": "string",
71 + "countryName": "string",
72 + "hasAlcohol": true,
73 + "hasFreeWifi": true,
74 + "hasMetro": true,
75 + "hasPool": true,
76 + "hasMall": true,
77 + "cancellationPolicyDescription": "string",
78 + "cancellationPolicy": {
79 + "cancellationPolicyCode": "string",
80 + "noShowChargeValue": 0,
81 + "noShowChargeValueType": "string",
82 + "earlyDepartureChargeValue": 0,
83 + "earlyDepartureChargeValueType": "string",
84 + "conditions": [
85 + {
86 + "timeunits": 0,
87 + "timeunitType": "string",
88 + "timeOffsetTypeName": "string",
89 + "chargeValue": 0,
90 + "chargeValueType": "string"
91 + }
92 + ]
93 + }
94 + },
95 + "flight": {
96 + "id": "string",
97 + "departureDate": "2023-12-18T14:03:07.553Z",
98 + "returnDate": "2023-12-18T14:03:07.553Z",
99 + "departureTicketsLeft": 0,
100 + "returnTicketsLeft": 0,
101 + "departureAvailabilityType": "OnRequest",
102 + "returnAvailabilityType": "OnRequest",
103 + "isTwoWay": true,
104 + "departureSegments": [
105 + {
106 + "airlineCode": "string",
107 + "airlineName": "string",
108 + "flightCode": "string",
109 + "class": "string",
110 + "lugageWeight": 0,
111 + "handLugageWeight": 0,
112 + "departureFlightDate": "2023-12-18T14:03:07.553Z",
113 + "departureCountryName": "string",
114 + "departureCityName": "string",
115 + "departureAirportCode": "string",
116 + "departureAirportName": "string",
117 + "departureTerminalCode": "string",
118 + "arrivalFlightDate": "2023-12-18T14:03:07.553Z",
119 + "arrivalCountryName": "string",
120 + "arrivalCityName": "string",
121 + "arrivalAirportCode": "string",
122 + "arrivalAirportName": "string",
123 + "arrivalTerminalCode": "string",
124 + "flightDuration": "string",
125 + "baggages": [
126 + {
127 + "baggageCode": "string",
128 + "description": "string",
129 + "price": 0,
130 + "currency": "string",
131 + "included": true
132 + }
133 + ]
134 + }
135 + ],
136 + "returnSegments": [
137 + {
138 + "airlineCode": "string",
139 + "airlineName": "string",
140 + "flightCode": "string",
141 + "class": "string",
142 + "lugageWeight": 0,
143 + "handLugageWeight": 0,
144 + "departureFlightDate": "2023-12-18T14:03:07.553Z",
145 + "departureCountryName": "string",
146 + "departureCityName": "string",
147 + "departureAirportCode": "string",
148 + "departureAirportName": "string",
149 + "departureTerminalCode": "string",
150 + "arrivalFlightDate": "2023-12-18T14:03:07.553Z",
151 + "arrivalCountryName": "string",
152 + "arrivalCityName": "string",
153 + "arrivalAirportCode": "string",
154 + "arrivalAirportName": "string",
155 + "arrivalTerminalCode": "string",
156 + "flightDuration": "string",
157 + "baggages": [
158 + {
159 + "baggageCode": "string",
160 + "description": "string",
161 + "price": 0,
162 + "currency": "string",
163 + "included": true
164 + }
165 + ]
166 + }
167 + ]
168 + },
169 + "extraServices": [
170 + {
171 + "extraServiceCode": "string",
172 + "extraServiceTypeCode": "string",
173 + "isMandatory": 0,
174 + "extraServiceName": "string",
175 + "minimalServiceAmount": 0,
176 + "includedPriceCode": "string",
177 + "prices": [
178 + {
179 + "extraServicePriceCode": "string",
180 + "displayName": "string",
181 + "restrictionInfo": "string",
182 + "additionalInfo": "string",
183 + "price": 0,
184 + "extraPrice": 0,
185 + "currency": "string"
186 + }
187 + ]
188 + }
189 + ],
190 + "insurancePrice": {
191 + "name": "string",
192 + "price": 0,
193 + "priceSurcarge": 0,
194 + "actualStartDate": "2023-12-18T14:03:07.553Z",
195 + "actualEndDate": "2023-12-18T14:03:07.553Z",
196 + "optional": true,
197 + "includedInPackagePrice": true
198 + },
199 + "cacheKey": "string"
200 + }
84 84  }
85 85  {{/code}}
86 86  
... ... @@ -89,13 +89,8 @@
89 89  
90 90  {{code language="json"}}
91 91  {
92 - "error": true,
93 - "errorCode": "string",
94 - "errorDescription": "string",
95 - "userErrorDescription": "string",
96 96   "packages": [
97 97   {
98 - "cacheKey": "string",
99 99   "id": "string",
100 100   "priceCurrency": "string",
101 101   "totalPrice": 0,
... ... @@ -118,8 +118,8 @@
118 118   "roomCategoryName": "string",
119 119   "placementTypeName": "string",
120 120   "placementDescription": "string",
121 - "checkInDate": "2023-12-14T13:47:13.396Z",
122 - "checkOutDate": "2023-12-14T13:47:13.396Z",
233 + "checkInDate": "2023-12-18T14:03:10.148Z",
234 + "checkOutDate": "2023-12-18T14:03:10.148Z",
123 123   "adults": 0,
124 124   "children": 0,
125 125   "districtUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
... ... @@ -153,8 +153,8 @@
153 153   },
154 154   "flight": {
155 155   "id": "string",
156 - "departureDate": "2023-12-14T13:47:13.396Z",
157 - "returnDate": "2023-12-14T13:47:13.396Z",
268 + "departureDate": "2023-12-18T14:03:10.148Z",
269 + "returnDate": "2023-12-18T14:03:10.148Z",
158 158   "departureTicketsLeft": 0,
159 159   "returnTicketsLeft": 0,
160 160   "departureAvailabilityType": "OnRequest",
... ... @@ -168,13 +168,13 @@
168 168   "class": "string",
169 169   "lugageWeight": 0,
170 170   "handLugageWeight": 0,
171 - "departureFlightDate": "2023-12-14T13:47:13.396Z",
283 + "departureFlightDate": "2023-12-18T14:03:10.148Z",
172 172   "departureCountryName": "string",
173 173   "departureCityName": "string",
174 174   "departureAirportCode": "string",
175 175   "departureAirportName": "string",
176 176   "departureTerminalCode": "string",
177 - "arrivalFlightDate": "2023-12-14T13:47:13.396Z",
289 + "arrivalFlightDate": "2023-12-18T14:03:10.148Z",
178 178   "arrivalCountryName": "string",
179 179   "arrivalCityName": "string",
180 180   "arrivalAirportCode": "string",
... ... @@ -200,13 +200,13 @@
200 200   "class": "string",
201 201   "lugageWeight": 0,
202 202   "handLugageWeight": 0,
203 - "departureFlightDate": "2023-12-14T13:47:13.396Z",
315 + "departureFlightDate": "2023-12-18T14:03:10.148Z",
204 204   "departureCountryName": "string",
205 205   "departureCityName": "string",
206 206   "departureAirportCode": "string",
207 207   "departureAirportName": "string",
208 208   "departureTerminalCode": "string",
209 - "arrivalFlightDate": "2023-12-14T13:47:13.396Z",
321 + "arrivalFlightDate": "2023-12-18T14:03:10.148Z",
210 210   "arrivalCountryName": "string",
211 211   "arrivalCityName": "string",
212 212   "arrivalAirportCode": "string",
... ... @@ -250,16 +250,14 @@
250 250   "name": "string",
251 251   "price": 0,
252 252   "priceSurcarge": 0,
253 - "actualStartDate": "2023-12-14T13:47:13.396Z",
254 - "actualEndDate": "2023-12-14T13:47:13.396Z",
365 + "actualStartDate": "2023-12-18T14:03:10.148Z",
366 + "actualEndDate": "2023-12-18T14:03:10.148Z",
255 255   "optional": true,
256 256   "includedInPackagePrice": true
257 - }
369 + },
370 + "cacheKey": "string"
258 258   }
259 - ],
260 - "pagingId": "string",
261 - "pageNumber": 0,
262 - "pageCount": 0
372 + ]
263 263  }
264 264  {{/code}}
265 265  
... ... @@ -274,19 +274,10 @@
274 274  === Schema ===
275 275  
276 276  {{success}}
277 -SearchTourPackagesResponse{
387 +GetOtherFlightsResponse{
278 278  
279 -|error|boolean
280 -|errorCode|string
281 -nullable: true
282 -|errorDescription|string
283 -nullable: true
284 -|userErrorDescription|string
285 -nullable: true
286 286  |packages|[
287 287  nullable: trueTourPackage{(((
288 -|cacheKey|string
289 -nullable: true
290 290  |id|string
291 291  nullable: true
292 292  |priceCurrency|string
... ... @@ -539,13 +539,11 @@
539 539  
540 540  }
541 541  )))
643 +|cacheKey|string
644 +nullable: true
542 542  
543 543  }]
544 544  )))
545 -|pagingId|string
546 -nullable: true
547 -|pageNumber|integer($int64)
548 -|pageCount|integer($int64)
549 549  
550 550  }
551 551  {{/success}}