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 14.1
edited by Giorgi Mdivnishvili
on 2024/04/11 17:03
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 +Before book, 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}}