Changes for page 1. SearchTourPackages

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

From version 15.1
edited by Giorgi Mdivnishvili
on 2023/12/26 14:44
Change comment: There is no comment for this version
To version 13.1
edited by Giorgi Mdivnishvili
on 2023/12/19 18:05
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -85,65 +85,6 @@
85 85  {{/code}}
86 86  
87 87  
88 -== Request example ==
89 -
90 -{{code language="Json"}}
91 -{
92 - "departureCountryCode": "KZ",
93 - "departureCityUID": "f0ba6324-f337-405c-8cc7-23d62cf664e8",
94 - "arrivalCountryCode": "AE",
95 - "arrivalLocations": [
96 - {
97 - "type": "city",
98 - "label": "Dubai",
99 - "value": "f5185fa3-3f56-44ed-bf6b-80386a33caa2",
100 - "tag": "Dubai"
101 - }
102 - ],
103 - "checkInDate": "2024-02-05T20:00:00.000Z",
104 - "checkInDateTo": "2024-02-10T20:00:00.000Z",
105 -
106 - "stayDays": 3,
107 - "stayDaysTo": 6,
108 -
109 - "airlineCode": "",
110 - "ticketType": "",
111 - "directFlightsOnly": true,
112 - "longConnectTime": true,
113 - "adults": 1,
114 - "children": 1,
115 - "childrenAges": [
116 - 2
117 - ],
118 - "extendedSearch": false,
119 - "totalPriceFrom": 100,
120 - "totalPriceTo": 15000,
121 - "recommended": true,
122 - "popular": true,
123 - "freeSale": true,
124 - "groupByHotel": true,
125 - "hotelCodes": [
126 -
127 - ],
128 - "mealPlans": [
129 -
130 - ],
131 - "hotelClasses": [
132 -
133 - ],
134 - "hotelTypes": [
135 -
136 - ],
137 - "hotelServices": [
138 -
139 - ],
140 - "pagingId": "",
141 - "pageNumber": 10,
142 - "pageRowCount": 10
143 -}
144 -{{/code}}
145 -
146 -
147 147  == Response Body ==
148 148  
149 149  {{code language="json"}}
... ... @@ -323,156 +323,10 @@
323 323  {{/code}}
324 324  
325 325  
326 -== Response example ==
267 +=== example ===
327 327  
328 328  {{code language="Json"}}
329 -{
330 - "packages": [
331 - {
332 - "cacheKey": "c705ab31e00e4f9a81c2fd46b2cdbb47f6fd9a6e16984236beb979b31aefafa4:{79}:i:10",
333 - "id": "tour:b01c168e-2ea7-4ea6-b6e0-55abb8cab0a0:da894a1e-88c0-4877-b216-0eeeabe186f3:4298d06f-4344-4a39-ad98-071b7760cf30",
334 - "priceCurrency": "USD",
335 - "totalPrice": 1033.53,
336 - "agentCommissionPercent": 0.0,
337 - "agentCommissionAmount": 0.0,
338 - "includedExtrasAmount": 0,
339 - "priceDifference": 0,
340 - "hotel": {
341 - "hotelPriceId": "da894a1e-88c0-4877-b216-0eeeabe186f3",
342 - "providerId": 13,
343 - "hotelName": "Mercure Dubai Barsha Heights Suites Apartments",
344 - "hotelCode": "5f125310-7025-4807-a4c6-49cd284c9c14",
345 - "nigths": 3,
346 - "mealPlan": "BB",
347 - "hotelClass": "4",
348 - "availabilityType": "FreeSale",
349 - "availableRoomsCount": 0,
350 - "fewRooms": true,
351 - "roomCategoryCode": "bc5f2224-bd4c-49b2-ab57-01eb7fa80d41",
352 - "roomCategoryName": "1 B/R Suite City View",
353 - "placementTypeName": "DBL",
354 - "checkInDate": "2024-02-09T20:00:00.000Z",
355 - "checkOutDate": "2024-02-12T20:00:00.000Z",
356 - "adults": 1,
357 - "children": 1,
358 - "districtUID": "4c65f6ed-902b-4fd8-9419-af7884c22c5e",
359 - "districtName": "Al Barsha",
360 - "cityUID": "f5185fa3-3f56-44ed-bf6b-80386a33caa2",
361 - "cityName": "Dubai",
362 - "countryCode": "AE",
363 - "countryName": "United Arab Emirates",
364 - "hasAlcohol": false,
365 - "hasFreeWifi": true,
366 - "hasMetro": true,
367 - "hasPool": true,
368 - "hasMall": false,
369 - "cancellationPolicyDescription": "Cancellation Policy: 5 Day Before Arrival: 100.00 %, Early Departure: 100.00 %, NoShow: 100.00 %",
370 - "cancellationPolicy": {
371 - "noShowChargeValue": 100.0,
372 - "noShowChargeValueType": "%",
373 - "earlyDepartureChargeValue": 100.0,
374 - "earlyDepartureChargeValueType": "%",
375 - "conditions": [
376 - {
377 - "timeunits": 5,
378 - "timeunitType": "Day",
379 - "timeOffsetTypeName": "Before Arrival",
380 - "chargeValue": 100.0,
381 - "chargeValueType": "%"
382 - }
383 - ]
384 - }
385 - },
386 - "flight": {
387 - "id": "4298d06f-4344-4a39-ad98-071b7760cf30",
388 - "departureDate": "2024-02-09T20:00:00.000Z",
389 - "returnDate": "2024-02-12T20:00:00.000Z",
390 - "departureTicketsLeft": 7,
391 - "returnTicketsLeft": 7,
392 - "departureAvailabilityType": "FewPlaces",
393 - "returnAvailabilityType": "FewPlaces",
394 - "isTwoWay": true,
395 - "sameBaggageForAll": false,
396 - "totalBaggage": false,
397 - "departureSegments": [
398 - {
399 - "airlineCode": "KC",
400 - "airlineName": "Air Astana-",
401 - "flightCode": "KC897",
402 - "class": "econom",
403 - "lugageWeight": 20,
404 - "handLugageWeight": 6,
405 - "departureFlightDate": "2024-02-09T20:00:00.000Z",
406 - "departureCountryName": "Kazakhstan",
407 - "departureCityName": "Almaty",
408 - "departureAirportCode": "ALA",
409 - "departureAirportName": "Almaty Intl Airport",
410 - "departureTerminalCode": "ALA",
411 - "arrivalFlightDate": "2024-02-09T20:00:00.000Z",
412 - "arrivalCountryName": "United Arab Emirates",
413 - "arrivalCityName": "Dubai",
414 - "arrivalAirportCode": "DXB",
415 - "arrivalAirportName": "Dubai Intl Airport",
416 - "arrivalTerminalCode": "DXB1",
417 - "flightDuration": "0h 50m"
418 - }
419 - ],
420 - "returnSegments": [
421 - {
422 - "airlineCode": "KC",
423 - "airlineName": "Air Astana-",
424 - "flightCode": "KC900",
425 - "class": "econom",
426 - "lugageWeight": 20,
427 - "handLugageWeight": 6,
428 - "departureFlightDate": "2024-02-12T20:00:00.000Z",
429 - "departureCountryName": "United Arab Emirates",
430 - "departureCityName": "Dubai",
431 - "departureAirportCode": "DXB",
432 - "departureAirportName": "Dubai Intl Airport",
433 - "departureTerminalCode": "DXB1",
434 - "arrivalFlightDate": "2024-02-12T20:00:00.000Z",
435 - "arrivalCountryName": "Kazakhstan",
436 - "arrivalCityName": "Almaty",
437 - "arrivalAirportCode": "ALA",
438 - "arrivalAirportName": "Almaty Intl Airport",
439 - "arrivalTerminalCode": "ALA",
440 - "flightDuration": "8h 15m"
441 - }
442 - ],
443 - "passengers": [
444 - {
445 - "id": "42768722011000004-A1",
446 - "isAdult": true,
447 - "forwardBaggages": [],
448 - "backwardBaggages": []
449 - },
450 - {
451 - "id": "42768722011000004-C1",
452 - "isAdult": false,
453 - "forwardBaggages": [],
454 - "backwardBaggages": []
455 - }
456 - ]
457 - },
458 - "extraServices": [],
459 - "insurancePrice": {
460 - "name": "Medical INS (N10000)",
461 - "price": 17.92,
462 - "priceSurcarge": 0.0,
463 - "actualStartDate": "2024-02-09T20:00:00.000Z",
464 - "actualEndDate": "2024-02-12T20:00:00.000Z",
465 - "optional": false,
466 - "includedInPackagePrice": true
467 - }
468 - }
469 - ],
470 - "pagingId": "79",
471 - "pageNumber": 10,
472 - "pageCount": 2452,
473 - "totalCount": 2452,
474 - "error": false
475 -}
270 +X
476 476  {{/code}}
477 477  
478 478  
... ... @@ -755,73 +755,4 @@
755 755  }
756 756  {{/success}}
757 757  
758 -
759 -== Definitions ==
760 -
761 -
762 -=== Paging and Caching ===
763 -
764 -During the first request, Paging id must be  empty like this  ( "pagingId": "",)  pagenumber is the number of the page, pagerowcount means number of the given result in one page. So in the first request we can search
765 -
766 -
767 -==== first request ====
768 -
769 -{{code language="Json"}}
770 - {
771 - "pagingId": "",
772 - "pageNumber": 1,
773 - "pageRowCount":10
774 - }
775 -{{/code}}
776 -
777 -
778 -==== Request with caching ====
779 -
780 -{{code language="Json"}}
781 - {
782 - "pagingId": "80",
783 - "pageNumber": 1,
784 - "pageRowCount":10
785 - }
786 -{{/code}}
787 -
788 -
789 -=== search parameter options ===
790 -
791 -in the request body it's available to filter search results with parameters. parameter examples:
792 -
793 -{{code language="Json"}}
794 - { "totalPriceFrom": 500,
795 - "totalPriceTo": 10000,
796 - "hotelTypes": [
797 - "CityHotel",
798 - "BeachHotel",
799 - "SecondLineBeach"
800 - ],
801 - "hotelClasses": [
802 - "1",
803 - "2",
804 - "3",
805 - "4",
806 - "5",
807 - "6"
808 - ],
809 - "hotelServices": [
810 - "HasAlcohol",
811 - "HasFreeWifi",
812 - "HasMetro",
813 - "HasPool",
814 - "HasMall"
815 - ],
816 - "mealPlans": [
817 - "RO",
818 - "BB",
819 - "HB",
820 - "FB",
821 - "AL"
822 - ]
823 -}
824 -{{/code}}
825 -
826 -
827 827