Changes for page 1. SearchTourPackages

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

From version 25.1
edited by Giorgi Mdivnishvili
on 2024/04/10 11:12
Change comment: There is no comment for this version
To version 19.1
edited by Giorgi Mdivnishvili
on 2024/01/09 07:20
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -6,11 +6,9 @@
6 6  
7 7  = Method Description =
8 8  
9 -Tour package mean, tour with hotel and flight together. Using this method gives data about full package availability with flight and hotel options.
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.
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.
12 12  
13 -
14 14  == Endpoint URL - [POST] ==
15 15  
16 16  {{info}}
... ... @@ -42,13 +42,13 @@
42 42   "tag": "string"
43 43   }
44 44   ],
45 - "checkInDate": "2023-12-14",
46 - "checkInDateTo": "2023-12-14",
47 - "checkOutDate": "2023-12-14",
43 + "checkInDate": "2023-12-14T13:43:54.766Z",
44 + "checkInDateTo": "2023-12-14T13:43:54.766Z",
45 + "checkOutDate": "2023-12-14T13:43:54.766Z",
48 48   "stayDays": 0,
49 49   "stayDaysTo": 0,
50 - "departureDate": "2023-12-14",
51 - "returnDate": "2023-12-14",
48 + "departureDate": "2023-12-14T13:43:54.766Z",
49 + "returnDate": "2023-12-14T13:43:54.766Z",
52 52   "airlineCode": "string",
53 53   "ticketType": "string",
54 54   "directFlightsOnly": true,
... ... @@ -761,109 +761,6 @@
761 761  == Definitions ==
762 762  
763 763  
764 -**Request Parameters **
765 -
766 -(% class="table-bordered" %)
767 -|=Field|=Type|=Description
768 -|departureCountryCode|string|The ISO 3166-1 alpha-2 country code for the departure country. For example, "KZ" for Kazakhstan.
769 -|departureCityUID|string|The unique identifier for the departure city.
770 -|arrivalCountryCode|string|The ISO 3166-1 alpha-2 country code for the arrival country. For example, "AE" for United Arab Emirates.
771 -|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.
772 -|checkInDate|string|The check-in date in ISO 8601 format.
773 -|checkInDateTo|string|The latest possible check-in date in ISO 8601 format.
774 -|stayDays|integer|The minimum number of days to stay.
775 -|stayDaysTo|integer|The maximum number of days to stay.
776 -|airlineCode|string|The code of the airline. This field can be empty.
777 -|ticketType|string|The type of the ticket. This field can be empty.
778 -|directFlightsOnly|boolean|Indicates whether to search for direct flights only.
779 -|longConnectTime|boolean|Indicates whether to include flights with long connection times.
780 -|adults|integer|The number of adults.
781 -|children|integer|The number of children.
782 -|childrenAges|array|An array of integers, each representing the age of a child.
783 -|extendedSearch|boolean|Indicates whether to perform an extended search.
784 -|totalPriceFrom|float|The minimum total price.
785 -|totalPriceTo|float|The maximum total price.
786 -|recommended|boolean|Indicates whether to include recommended packages.
787 -|popular|boolean|Indicates whether to include popular packages.
788 -|freeSale|boolean|Indicates whether to include free sale packages.
789 -|groupByHotel|boolean|Indicates whether to group the results by hotel.
790 -|hotelCodes|array|An array of strings, each representing a hotel code. This field can be empty.
791 -|mealPlans|array|An array of meal plans. This field can be empty.
792 -|hotelClasses|array|An array of hotel classes. This field can be empty.
793 -|hotelTypes|array|An array of hotel types. This field can be empty.
794 -|hotelServices|array|An array of hotel services. This field can be empty.
795 -|pagingId|string|The paging ID for paginated results. This field can be empty.
796 -|pageNumber|integer|The page number for paginated results.
797 -|pageRowCount|integer|The number of rows per page for paginated results.
798 -
799 -
800 -(% class="wikigeneratedid" %)
801 -**Response Parameters**
802 -
803 -(% class="table-bordered" %)
804 -|=Field|=Type|=Description
805 -|packages|array|An array of packages available. Each package contains:
806 -|cacheKey|string|A unique identifier for the cache.
807 -|id|string|A unique identifier for the package.
808 -|priceCurrency|string|The currency in which the price is displayed.
809 -|totalPrice|float|The total price of the package.
810 -|agentCommissionPercent|float|The commission percentage for the agent.
811 -|agentCommissionAmount|float|The commission amount for the agent.
812 -|includedExtrasAmount|integer|The amount of extras included in the package.
813 -|priceDifference|integer|The difference in price from the original price.
814 -|hotel|object|An object containing details about the hotel.
815 -|hotelPriceId|string|A unique identifier for the hotel price.
816 -|providerId|integer|A unique identifier for the provider.
817 -|hotelName|string|The name of the hotel.
818 -|hotelCode|string|A unique code for the hotel.
819 -|nigths|integer|The number of nights for the stay.
820 -|mealPlan|string|The meal plan for the stay.
821 -|hotelClass|string|The class or rating of the hotel.
822 -|availabilityType|string|The availability type of the hotel.
823 -|availableRoomsCount|integer|The number of available rooms in the hotel.
824 -|fewRooms|boolean|Indicates whether there are few rooms left.
825 -|roomCategoryCode|string|A unique code for the room category.
826 -|roomCategoryName|string|The name of the room category.
827 -|placementTypeName|string|The name of the placement type.
828 -|checkInDate|string|The check-in date in ISO 8601 format.
829 -|checkOutDate|string|The check-out date in ISO 8601 format.
830 -|adults|integer|The number of adults for the stay.
831 -|children|integer|The number of children for the stay.
832 -|districtUID|string|A unique identifier for the district.
833 -|districtName|string|The name of the district.
834 -|cityUID|string|A unique identifier for the city.
835 -|cityName|string|The name of the city.
836 -|countryCode|string|The ISO 3166-1 alpha-2 country code.
837 -|countryName|string|The name of the country.
838 -|hasAlcohol|boolean|Indicates whether the hotel serves alcohol.
839 -|hasFreeWifi|boolean|Indicates whether the hotel offers free Wi-Fi.
840 -|hasMetro|boolean|Indicates whether the hotel is near a metro station.
841 -|hasPool|boolean|Indicates whether the hotel has a pool.
842 -|hasMall|boolean|Indicates whether the hotel is near a shopping mall.
843 -|cancellationPolicyDescription|string|The description of the cancellation policy.
844 -|cancellationPolicy|object|An object containing details about the cancellation policy.
845 -|flight|object|An object containing details about the flight.
846 -|id|string|A unique identifier for the flight.
847 -|departureDate|string|The departure date in ISO 8601 format.
848 -|returnDate|string|The return date in ISO 8601 format.
849 -|departureTicketsLeft|integer|The number of departure tickets left.
850 -|returnTicketsLeft|integer|The number of return tickets left.
851 -|departureAvailabilityType|string|The availability type of the departure flight.
852 -|returnAvailabilityType|string|The availability type of the return flight.
853 -|isTwoWay|boolean|Indicates whether the flight is two-way.
854 -|sameBaggageForAll|boolean|Indicates whether the same baggage is applicable for all passengers.
855 -|totalBaggage|boolean|Indicates whether total baggage is included.
856 -|departureSegments|array|An array of objects, each representing a departure segment.
857 -|returnSegments|array|An array of objects, each representing a return segment.
858 -|passengers|array|An array of objects, each representing a passenger.
859 -|extraServices|array|An array of extra services included in the package.
860 -|insurancePrice|object|An object containing details about the insurance price.
861 -|pagingId|string|The paging ID for paginated results.
862 -|pageNumber|integer|The page number for paginated results.
863 -|pageCount|integer|The total number of pages.
864 -|totalCount|integer|The total count of packages.
865 -|error|boolean|Indicates whether there was an error.
866 -
867 867  === Paging and Caching ===
868 868  
869 869  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: