Skip to Content

Changes for page 1. SearchTourPackages

Last modified by Giorgi Mdivnishvili on 2025/02/12 15:25
From version 14.1
edited by Giorgi Mdivnishvili
on 2023/12/26 14:25
Change comment: There is no comment for this version
To version 21.1
edited by Giorgi Mdivnishvili
on 2024/01/10 17:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -6,13 +6,15 @@
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 +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-14T13:43:54.766Z",
44 - "checkInDateTo": "2023-12-14T13:43:54.766Z",
45 - "checkOutDate": "2023-12-14T13: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-14T13:43:54.766Z",
49 - "returnDate": "2023-12-14T13: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,
... ... @@ -755,3 +755,93 @@
755 755  }
756 756  {{/success}}
757 757  
760 +
761 +== Definitions ==
762 +
763 +
764 +=== Paging and Caching ===
765 +
766 +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:
767 +
768 +
769 +==== first request ====
770 +
771 +{{code language="Json"}}
772 + {
773 + "pagingId": "",
774 + "pageNumber": 1,
775 + "pageRowCount":10
776 + }
777 +{{/code}}
778 +
779 +
780 +==== Request with caching ====
781 +
782 +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
783 +
784 +{{code language="Json"}}
785 + {
786 + "pagingId": "80",
787 + "pageNumber": 1,
788 + "pageRowCount":10
789 + }
790 +{{/code}}
791 +
792 +
793 +=== search parameter options ===
794 +
795 +in the request body it's available to filter search results with parameters. parameter examples:
796 +
797 +{{code language="Json"}}
798 + { "totalPriceFrom": 500,
799 + "totalPriceTo": 10000,
800 + "hotelTypes": [
801 + "CityHotel",
802 + "BeachHotel",
803 + "SecondLineBeach"
804 + ],
805 + "hotelClasses": [
806 + "1",
807 + "2",
808 + "3",
809 + "4",
810 + "5",
811 + "6"
812 + ],
813 + "hotelServices": [
814 + "HasAlcohol",
815 + "HasFreeWifi",
816 + "HasMetro",
817 + "HasPool",
818 + "HasMall"
819 + ],
820 + "mealPlans": [
821 + "RO",
822 + "BB",
823 + "HB",
824 + "FB",
825 + "AL"
826 + ]
827 +}
828 +{{/code}}
829 +
830 +
831 +
832 +== Important ==
833 +
834 +{{error}}
835 +It's Important to in every other request header, put Auth token
836 +
837 +**Key **- Authorization
838 +
839 +**Value **- Bearer Token what is given in this response.
840 +
841 +
842 +**also note in headers that:**
843 +
844 +Content-Type - application/json
845 +
846 +**Key - **X-nugios-timezone
847 +
848 +**Value **- 240
849 +{{/error}}