Changes for page 1. SearchTourPackages
Last modified by Giorgi Mdivnishvili on 2025/02/12 15:25
From version 16.1
edited by Giorgi Mdivnishvili
on 2023/12/26 15:05
on 2023/12/26 15:05
Change comment:
There is no comment for this version
To version 23.1
edited by Giorgi Mdivnishvili
on 2024/04/10 10:50
on 2024/04/10 10:50
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -6,13 +6,15 @@ 6 6 7 7 = Method Description = 8 8 9 -T he initial method of the integrationprocessisauthorization.Youwill be providedwithatestuser username andpasswordtonerate the accesstokenthatyouwillneed topassinallthefollowingmethods.9 +Tour package mean, tour with hotel and flight together. Using this method gives data about full package availability with flight and hotel options. 10 10 11 +It's possible to receive data as current dates, also in date ranges using parameter "stayDays": 0, "stayDaysTo": 0. the maximum difference between the days can be 7. Below you can see examples. 11 11 13 + 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]]17 +[[https:~~/~~/integration.kazunion.com/api/TourPackages/SearchTourPackages>>https://integration.kazunion.com/api/TourPackages/SearchTourPackages]] 16 16 {{/info}} 17 17 18 18 == Request Parameters == ... ... @@ -40,13 +40,13 @@ 40 40 "tag": "string" 41 41 } 42 42 ], 43 - "checkInDate": "2023-12-14 T13:43:54.766Z",44 - "checkInDateTo": "2023-12-14 T13:43:54.766Z",45 - "checkOutDate": "2023-12-14 T13:43:54.766Z",45 + "checkInDate": "2023-12-14", 46 + "checkInDateTo": "2023-12-14", 47 + "checkOutDate": "2023-12-14", 46 46 "stayDays": 0, 47 47 "stayDaysTo": 0, 48 - "departureDate": "2023-12-14 T13:43:54.766Z",49 - "returnDate": "2023-12-14 T13:43:54.766Z",50 + "departureDate": "2023-12-14", 51 + "returnDate": "2023-12-14", 50 50 "airlineCode": "string", 51 51 "ticketType": "string", 52 52 "directFlightsOnly": true, ... ... @@ -758,10 +758,49 @@ 758 758 759 759 == Definitions == 760 760 763 +Request Parameters 761 761 765 +(% class="table-bordered" %) 766 +|=Field|=Type|=Description 767 +|departureCountryCode|string|The ISO 3166-1 alpha-2 country code for the departure country. For example, "KZ" for Kazakhstan. 768 +|departureCityUID|string|The unique identifier for the departure city. 769 +|arrivalCountryCode|string|The ISO 3166-1 alpha-2 country code for the arrival country. For example, "AE" for United Arab Emirates. 770 +|arrivalLocations|array|An array of objects, each representing an arrival location. Each object contains: type (string) - The type of the location. This can be "city". label (string) - The name of the location. value (string) - The unique identifier for the location. tag (string) - A tag for the location. 771 +|checkInDate|string|The check-in date in ISO 8601 format. 772 +|checkInDateTo|string|The latest possible check-in date in ISO 8601 format. 773 +|stayDays|integer|The minimum number of days to stay. 774 +|stayDaysTo|integer|The maximum number of days to stay. 775 +|airlineCode|string|The code of the airline. This field can be empty. 776 +|ticketType|string|The type of the ticket. This field can be empty. 777 +|directFlightsOnly|boolean|Indicates whether to search for direct flights only. 778 +|longConnectTime|boolean|Indicates whether to include flights with long connection times. 779 +|adults|integer|The number of adults. 780 +|children|integer|The number of children. 781 +|childrenAges|array|An array of integers, each representing the age of a child. 782 +|extendedSearch|boolean|Indicates whether to perform an extended search. 783 +|totalPriceFrom|float|The minimum total price. 784 +|totalPriceTo|float|The maximum total price. 785 +|recommended|boolean|Indicates whether to include recommended packages. 786 +|popular|boolean|Indicates whether to include popular packages. 787 +|freeSale|boolean|Indicates whether to include free sale packages. 788 +|groupByHotel|boolean|Indicates whether to group the results by hotel. 789 +|hotelCodes|array|An array of strings, each representing a hotel code. This field can be empty. 790 +|mealPlans|array|An array of meal plans. This field can be empty. 791 +|hotelClasses|array|An array of hotel classes. This field can be empty. 792 +|hotelTypes|array|An array of hotel types. This field can be empty. 793 +|hotelServices|array|An array of hotel services. This field can be empty. 794 +|pagingId|string|The paging ID for paginated results. This field can be empty. 795 +|pageNumber|integer|The page number for paginated results. 796 +|pageRowCount|integer|The number of rows per page for paginated results. 797 + 798 + 799 +(% class="wikigeneratedid" %) 800 +Request Parameters 801 + 802 + 762 762 === Paging and Caching === 763 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 805 +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 like this: 765 765 766 766 767 767 ==== first request ==== ... ... @@ -777,6 +777,8 @@ 777 777 778 778 ==== Request with caching ==== 779 779 821 +as we receive response, in the end we can see pagingId- number, chich we can use for caching, and then just switch pagenumbers. for cleaning cache, it's important to make new request without pagingID 822 + 780 780 {{code language="Json"}} 781 781 { 782 782 "pagingId": "80", ... ... @@ -825,7 +825,7 @@ 825 825 826 826 827 827 828 - 871 +== Important == 829 829 830 830 {{error}} 831 831 It's Important to in every other request header, put Auth token ... ... @@ -843,4 +843,3 @@ 843 843 844 844 **Value **- 240 845 845 {{/error}} 846 -