Skip to Content

Wiki source code of 1. Hotels

Version 6.1 by Giorgi Mdivnishvili on 2024/02/26 16:09
Show last authors
1 **https:~/~/restapi.rustaronline.com/v1.01/api/hotels**
2
3 Method: GET
4
5 Parameters to pass: agentid and agentpassword
6
7 Sample URL: **https:~/~/restapi.rustaronline.com/v1.01/api/hotels?agentid=test.test&agentpassword=TestP@ssw0rd**
8
9
10 The method returns the list of hotels with the statuses and timestamps of the prices
11
12 Return value example:
13
14
15 {{code language="json"}}
16 {
17 "Code": "00",
18 "Message": "",
19 "Timestamp": "2016-06-27T19:20:00.7512185+04:00",
20 "Version": “1.01”,
21 "ResponseID": "b512a117-6745-493d-9fa4-828d79c0df1d",
22 "Data": [
23 {
24 "hotelid": "d6f9299f-5d94-4955-85e7-003e0383023c",
25 "hotelname": "Summer Land Motel - Sharjah",
26 "pricestatus": "ready",
27 "cityid": "f78ac3bc-f040-46d0-8319-2c52083080a6",
28 "cityname": "Sharjah",
29 "districtid": "7ac1bbc8-59ea-4977-b272-ed8553f94f9b",
30 "districtname": "Sharjah",
31 "hasalcohol": false,
32 "hasfreewifi": true,
33 "hasmall": false,
34 "hasmetro": false,
35 "haspool": true,
36 "hotelclass": "***",
37 "hoteltype": "City",
38 "popular": false,
39 "recommended": false,
40 "priceupdated": "2016-04-24T11:12:09.66",
41 "note": "Check-in time is 14:00 hrs, Check-out time is 12:00 hrs\r\n\r\n\r\nHotel guests can access the pool and beach of Beach Hotel Sharjah hotel - AED 20.00 ($5.50) for 1 person a day. \r\nHotel guests can access the pool and beach of Sharjah Carlton Hotel hotel - AED 20.00 ($5.50) for 1 person a day. \r\nHotel guests can access the pool and beach of Golden Beach Motel hotel - AED 15.00 ($4.10) for 1 person a day. \r\nThe hotel provides a group transfer to Dubai (Naser Square).\r\n\r\n\r\n",
42 "imageurl": "https://www.rustaronline.com/images/pages/hotels/thumbnail/F2EB7838-B479-4A81-BE9A-8113E06C70B5.jpg"
43 },
44 {
45 "hotelid": "60d6bb96-a8ba-4c14-908e-7a9227c34bf3",
46 "hotelname": "Burj Al Arab",
47 "pricestatus": "ready",
48 "cityid": "f5185fa3-3f56-44ed-bf6b-80386a33caa2",
49 "cityname": "Dubai",
50 "districtid": "e6f59e6e-4747-4c14-9b6b-a709cce36c33",
51 "districtname": "Jumeirah",
52 "hasalcohol": true,
53 "hasfreewifi": true,
54 "hasmall": false,
55 "hasmetro": false,
56 "haspool": true,
57 "hotelclass": "*****",
58 "hoteltype": "Beach",
59 "popular": false,
60 "recommended": false,
61 "priceupdated": "2016-06-19T14:17:39.65",
62 "note": null,
63 "imageurl": ""
64 }
65 ]
66 }
67
68 {{/code}}
69
70
71
72
73 **hotelid:**              GUID of the hotel in the database of Rustar. This GUID will be used to retrieve additional information (like prices) about the hotel
74
75 **hotelname:**        string. Name of the hotel
76
77 **pricestatus:**       string. "ready" or "pending". “ready” means that prices are ready to be downloaded. “pending” means that price registration is under processing and not all prices are available for the hotel. In case of “pending” the prices should be downloaded later when the status is changed to “ready”.
78
79 **cityid:**                GUID of the City where the hotel is located.
80
81 **cityname:**          string. Name of the city
82
83 **districtid:**          GUID of the district, where the hotel is located
84
85 **districtname: ** string. Name of the district
86
87 **hasalcohol:**        Boolean parameter. Describes whether hotel serves alcohol or not
88
89 **hasfreewifi:**       Boolean parameter. Describes whether free wifi is available in the rooms
90
91 **hasmall:**            Boolean parameter. Describes whether there is a shopping mall near the hotel
92
93 **hasmetro:**          Boolean parameter. Describes whether there is a metro station near the hotel
94
95 **haspool:**            Boolean parameter. Describes whether there is swimming pool in the hotel
96
97 **hotelclass:**         string. “*”,”~*~*”,”~*~**”,”~*~*~*~*”,”~*~*~*~**” or ”Apartments”. Number of stars or Apartment hotel
98
99 **hoteltype:**          string. "City" or “Beach”. Describes whether this hotel is located in the city or at the beach
100
101 **popular:**            Boolean. Describes if the hotel was popular last 7 days
102
103 **recommended:**   Boolean. True if the hotel is recommended by Rustar
104
105 **priceupdated:**    DateTime of the last price update
106
107 **note:**                  string. Free formed text
108
109 **imageurl:**           string. Optional. Points the URL for the image of the hotel if any.
110
111
112
113 |**Parameter**|**Description**
114 |**DepartingDate**|Date of depart  format example [10.01.2024 ~| DD.MM.YY]
115 |**ReturningDate**|Date of Return format example [17.01.2024 ~| DD.MM.YY]
116 |**CheckInDate**|Date of Hotel Checkin [10.01.2024 ~| DD.MM.YY]
117 |**CheckOutDate**|Date of Hotel Checkout [17.01.2024 ~| DD.MM.YY]
118 |**Adults**|Number of adults
119 |**Children**|Number of Children
120 |**ChildrenAges**|age of children, if there is more then one, ages must be defined by comma example [4,5] if there is no children, this parameter is not needed
121 |**DepartureCityCode**|CityCode of departure city- in this example, "5efe9cfb-a9a0-4f99-93f5-42716e4ccbb7", in this case this is Astana
122 |**ArrivalCountryCode**|Country code of the arrival country - in this example is for Georgia - "GE"
123 |**HotelCodes**|Hotel code of one, or several hotels- in this example - "4da03ca4-70c7-429d-944a-484b51e32eb1,5c27c701-cc81-4cc5-8042-2a2e908e70bc" - in case of several hotel codes they are separated with comma ","
124
125