Wiki source code of 4. Hotel Search

Version 20.1 by Giorgi Mdivnishvili on 2024/02/29 11:07

version	line-number	content
9.1	1	{{box cssClass="floatinginfobox" title="Contents"}}
1.1	2
	3
9.1	4	{{toc/}}
	5	{{/box}}
	6
8.1	7	= Method Description =
	8
	9
1.1	10	With the parameters provided in GetHotels and GetCities reponse, it’s avaible to search hotels with the desired parameters in Hotels Search.
	11
	12
4.1	13	endpoint : [[https:~~/~~/testapi.rustaronline.com/api/Hotels/Search>>url:https://testapi.rustaronline.com/api/Hotels/Search]]
1.1	14
4.1	15	Method POST
3.1	16
7.1	17
	18
8.1	19	== Request example: ==
4.1	20
3.1	21	{{code language="Json"}}
	22	{
7.1	23	"MaxResultCount":2,
	24	"MaxHotelCount":2,
	25	"contragentContactUID": "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",
	26	"countryMask": "TR",
	27	"CheckInDate": "2024-05-06",
	28	"CheckOutDate": "2024-05-07",
	29	"Adults": 1,
	30	"Children": 0,
	31	"ChildrenAges": "",
	32
2.1	33	"arrivalCities": [
1.1	34	{
7.1	35	"cityUID": "e1344ba0-5273-4fc1-b6c4-72446260f430"
2.1	36
1.1	37	}
	38	]
7.1	39	}
1.1	40
7.1	41	{{/code}}
	42
	43
11.1	44	(% class="table-bordered" %)
13.1	45	(% class="info" %)\|Parameter\|Value\|Description
	46	\| "MaxResultCount"\|2,\|Maximum number of results to display
	47	\| "MaxHotelCount"\|2,\|Maximum number of hotels to display results
	48	\| "contragentContactUID"\| "55a2fcfb-8378-4b73-ab1e-bc8e5c836f4e",\|A unique code assigned to each application user
17.1	49	\| "countryMask"\| "TR",\|Country code, which can be retrieved in [[Get Cities>>Get Cities]] method, in parameter [countrycode]
13.1	50	\| "CheckInDate"\| "2024-05-06",\|Check in date "YY-MM-DD"
	51	\| "CheckOutDate"\| "2024-05-07",\|Check out date "YY-MM-DD"
	52	\| "Adults"\| 1,\|number of Adults
	53	\| "Children"\| 0,\|Number of children
	54	\| "ChildrenAges"\| "",\|children ages, the must be separated with ","
15.1	55	\| "cityUID"\| "e1344ba0-5273-4fc1-b6c4-72446260f430"\|Code of the city, which is available in method [[Get Cities>>Get Cities]] in parameter [cityid]
10.1	56
16.1	57	== ==
	58
	59	(% class="wikigeneratedid" %)
	60	In case there is need to display hotels in whole country, no mater cities, it's possible to remove "arrivalCities" parameter.
	61
	62
8.1	63	== Response Example ==
7.1	64
	65
	66	{{code language="json"}}
	67	{
	68	"result": [
	69	{
	70	"resultID": 1656436810005000001,
	71	"hotelID": 871186,
	72	"providerID": 5,
	73	"roomCategoryCode": "ECO",
	74	"roomCategoryName": "Economic Room",
	75	"mealPlanName": "BB",
	76	"placementType": 1,
	77	"placementTypeName": "1 Adult",
	78	"priceCode": "BASERATE BB ECO",
	79	"priceCurrency": "EUR",
	80	"priceCurrencySrc": "EUR",
	81	"availability": 3,
	82	"availableRoomsCount": 1,
	83	"totalSellPriceSrc": 40.70,
	84	"totalSellPrice": 40.70,
	85	"totalPriceSurcharge": 0.00,
	86	"cancellationPolicyDescription": "Cancellation Policy: Non refundable",
	87	"cancellationPolicy": {
	88	"noShowChargeValue": 100.00,
	89	"noShowChargeValueType": "%",
	90	"earlyDepartureChargeValue": 100.00,
	91	"earlyDepartureChargeValueType": "%",
	92	"conditions": [
	93	{
	94	"timeunits": 365,
	95	"timeunitType": "Day",
	96	"timeOffsetTypeName": "Before Arrival",
	97	"chargeValue": 100.00,
	98	"chargeValueType": "%"
	99	}
	100	]
	101	},
	102	"searchId": 1656436810,
	103	"hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
	104	"id": 1656436810005000001,
	105	"hotel": {
	106	"hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
	107	"hotelName": "Istanbul Holiday Hotel",
	108	"hotelClass": "***",
	109	"cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430",
	110	"cityName": "Istanbul",
	111	"countryCode": "TR",
	112	"districtId": "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",
	113	"districtName": "Fatih",
	114	"note": ""
	115	},
	116	"adults": 1,
	117	"children": 0,
	118	"childrenAges": "",
	119	"childrenExeptInfants": 0,
	120	"checkInDate": "2024-05-06T00:00:00",
	121	"checkOutDate": "2024-05-07T00:00:00",
	122	"includedExtrasAmount": 0,
	123	"extraServices": []
	124	},
	125	{
	126	"resultID": 1656436810005000003,
	127	"hotelID": 871186,
	128	"providerID": 5,
	129	"roomCategoryCode": "STANDART-2",
	130	"roomCategoryName": "Standart Double or Twin Room",
	131	"mealPlanName": "BB",
	132	"placementType": 1,
	133	"placementTypeName": "1 Adult",
	134	"priceCode": "BASERATE BB STANDART",
	135	"priceCurrency": "EUR",
	136	"priceCurrencySrc": "EUR",
	137	"availability": 3,
	138	"availableRoomsCount": 1,
	139	"totalSellPriceSrc": 53.90,
	140	"totalSellPrice": 53.90,
	141	"totalPriceSurcharge": 0.00,
	142	"cancellationPolicyDescription": "Cancellation Policy: Non refundable",
	143	"cancellationPolicy": {
	144	"noShowChargeValue": 100.00,
	145	"noShowChargeValueType": "%",
	146	"earlyDepartureChargeValue": 100.00,
	147	"earlyDepartureChargeValueType": "%",
	148	"conditions": [
	149	{
	150	"timeunits": 365,
	151	"timeunitType": "Day",
	152	"timeOffsetTypeName": "Before Arrival",
	153	"chargeValue": 100.00,
	154	"chargeValueType": "%"
	155	}
	156	]
	157	},
	158	"searchId": 1656436810,
	159	"hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
	160	"id": 1656436810005000003,
	161	"hotel": {
	162	"hotelCode": "10b7bc34-2a03-495e-94bc-1092b07823f7",
	163	"hotelName": "Istanbul Holiday Hotel",
	164	"hotelClass": "***",
	165	"cityId": "e1344ba0-5273-4fc1-b6c4-72446260f430",
	166	"cityName": "Istanbul",
	167	"countryCode": "TR",
	168	"districtId": "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",
	169	"districtName": "Fatih",
	170	"note": ""
	171	},
	172	"adults": 1,
	173	"children": 0,
	174	"childrenAges": "",
	175	"childrenExeptInfants": 0,
	176	"checkInDate": "2024-05-06T00:00:00",
	177	"checkOutDate": "2024-05-07T00:00:00",
	178	"includedExtrasAmount": 0,
	179	"extraServices": []
	180	}
	181	],
	182	"error": false
2.1	183	}
	184	{{/code}}
1.1	185
18.1	186
	187
	188	(% class="table-bordered" %)
	189	(% class="info" %)\|Parameter\|value\|Description
	190	\|{\| \|
19.1	191	\| "resultID"\| 1656436810005000001,\|Unique ID of the Result
	192	\| "hotelID"\| 871186,\|Unique ID of the hotel
	193	\| "providerID"\| 5,\|provider id - (system internal)
	194	\| "roomCategoryCode"\| "ECO",\|Special code for Room Category type
	195	\| "roomCategoryName"\| "Economic Room",\|Name of the Room Category Type - definition of the "roomCategoryCode"
	196	\| "mealPlanName"\| "BB",\|Meal Plan code
	197	\| "placementType"\| 1,\|Placement type code - in this case 1 means single
	198	\| "placementTypeName"\| "1 Adult",\|Placement type name - definition of the "placementType"
	199	\| "priceCode"\| "BASERATE BB ECO",\|price code for the current option
18.1	200	\| "priceCurrency"\| "EUR",\|
	201	\| "priceCurrencySrc"\| "EUR",\|
19.1	202	\| "availability"\| 3,\|Availability
	203	\| "availableRoomsCount"\| 1,\|Number of available rooms for the current type of options
18.1	204	\| "totalSellPriceSrc"\| 40.70,\|
	205	\| "totalSellPrice"\| 40.70,\|
	206	\| "totalPriceSurcharge"\| 0.00,\|
19.1	207	\| "cancellationPolicyDescription"\| "Cancellation Policy Non refundable",\|TEXT DESCRIPTION OF THE CANCELLATION POLICY
18.1	208	\| "cancellationPolicy"\| {\|
	209	\| "noShowChargeValue"\| 100.00,\|
	210	\| "noShowChargeValueType"\| "%",\|
	211	\| "earlyDepartureChargeValue"\| 100.00,\|
	212	\| "earlyDepartureChargeValueType"\| "%",\|
	213	\| "conditions"\| [\|
	214	\| {\| \|
	215	\| "timeunits"\| 365,\|
	216	\| "timeunitType"\| "Day",\|
	217	\| "timeOffsetTypeName"\| "Before Arrival",\|
	218	\| "chargeValue"\| 100.00,\|
	219	\| "chargeValueType"\| "%"\|
	220	\| }\| \|
	221	\| ]\| \|
	222	\| },\| \|
19.1	223	\| "searchId"\| 1656436810,\|search id of the hotel
	224	\| "hotelCode"\| "10b7bc34-2a03-495e-94bc-1092b07823f7",\|Unique ID of the Hotel. Full List of the hotels is available in [[Get Hotels>>Get Hotels]] method
18.1	225	\| "id"\| 1656436810005000001,\|
	226	\| "hotel"\| {\|
20.1	227	\| "hotelCode"\| "10b7bc34-2a03-495e-94bc-1092b07823f7",\|Unique ID of the Hotel. Full List of the hotels is available in [[Get Hotels>>Get Hotels]] method
	228	\| "hotelName"\| "Istanbul Holiday Hotel",\|Full name of the Hotel
	229	\| "hotelClass"\| "~~*",\|Hotel Class in Stars
	230	\| "cityId"\| "e1344ba0-5273-4fc1-b6c4-72446260f430",\|Code of the city where hotel is located, which is available in method [[Get Cities>>Get Cities]] in parameter [cityid]
	231	\| "cityName"\| "Istanbul",\|Full Name of the City
	232	\| "countryCode"\| "TR",\|Country code, which can be retrieved in [[Get Cities>>Get Cities]] method, in parameter [countrycode]
	233	\| "districtId"\| "6ca0ed7e-7412-4e45-85b5-dd0d74cabc62",\|District unique code, where hotel is located.
	234	\| "districtName"\| "Fatih",\|Full name of the District
	235	\| "note"\| ""\|Hotel note - this is optional
18.1	236	\| },\| \|
20.1	237	\| "adults"\| 1,\|Number of the adults
	238	\| "children"\| 0,\|Number of the children
	239	\| "childrenAges"\| "",\|in case of children, here will be their ages
18.1	240	\| "childrenExeptInfants"\| 0,\|
20.1	241	\| "checkInDate"\| "2024-05-06T00000",\|date of the check in
	242	\| "checkOutDate"\| "2024-05-07T00000",\|date of the check out
18.1	243	\| "includedExtrasAmount"\| 0,\|
	244	\| "extraServices"\| []\|
	245	\| },\| \|

Wiki source code of 4. Hotel Search

Applications

Navigation