Hotel Availability Search
The Hotel Search Results API is designed to deliver hotel options tailored to the specific search criteria provided in your initial Hotel Search API request.
This API will return a list of hotels that match the criteria, including the location, number of guests (occupants), and the dates of stay (check-in and check-out). Each result set generated by the Hotel Search Results API comes with a unique token. This token is crucial for retrieving any missed or timed-out results in subsequent searches. By including the `nextToken` from a previous search in your next API request, you can access progressive search results seamlessly.
Hotel Search Request
Method | URL |
---|---|
POST | https://das.hotel.demircode.net/HotelAPI/hotel_search |
Hotel Search Elements
Element | Format | Description | Required |
---|---|---|---|
user_id | String | It is used to specify the user name | REQUIRED |
user_password | String | It is used to specify the password | REQUIRED |
access | String | It is used to access the website | REQUIRED |
ip_address | String | It is used to get ip_address of the system from which website is accessed | REQUIRED |
maxResult | Integer | Send how many results required in search response | REQUIRED |
latitude | Float | Latitude of the location | REQUIRED for geo-location wise search. |
longitude | Float | Longitude of the location | REQUIRED for geo-location wise search |
hotelCodes | Array | array of hotel code which you can get it from static content API, maximum limit 1000 hotels codes | REQUIRED for Hotelcode wise search |
city_name | string | name of city which you can get it from city loaction API. | REQUIRED for City wise search |
country_name | string | name of city which you can get it from city loaction API. | REQUIRED for City wise search |
radius | integer | Radius from center in KM | REQUIRED |
occupancy | Array | Array of rooms with pax details | REQUIRED |
room_no | Integer | Specify room number | REQUIRED |
adult | integer | Array of adult details for in the particular room | REQUIRED |
child | integer | Array of child details for in the particular room | REQUIRED |
child_age | Array | Array of child age details for in the particular child | REQUIRED |
checkin | Date | Date of check in (format (YYYY-MM-DD)) | REQUIRED |
checkout | Date | Date of check out (format (YYYY-MM-DD)) | REQUIRED |
requiredCurrency | String | 3-character ISO code that indicates the currency in which the rate is returned. | REQUIRED |
requiredLanguage | String | The language code for the language in which you want the descriptions to be returned. The Language code can get it from Language API | OPTIONAL |
nationality | String | To specify array of Alpha-2 Country Codes of nationality of lead guest. This may result in nationality wise concessions. | REQUIRED |
Sample Hotel Search Request
-
1 room, 2 adults and 0 child
{ "user_id": "<user_id>", "user_password": "<user_password>", "access": "Test", "ip_address": "<ip_address>", "requiredCurrency": "INR", "nationality": "IN", "checkin": "2020-04-17", "checkout": "2020-04-18", "latitude": 25.270265579224, "longitude": 55.307498931885, "hotelCodes": [ "22014", "24312", "24313", "24315", "24369", "24370", "100272" ], "city_name": "London", "country_name": "United Kingdom", "radius": 20, "maxResult": 20, "occupancy": [ { "room_no": 1, "adult": 2, "child": 0, "child_age": [ 0 ] } ] }
-
2 rooms, 1 room for 2 adults and 2 room for 1 adults and 2 children (5 and 7)
{ "user_id": "<user_id>", "user_password": "<user_password>", "access": "Test", "ip_address": "<ip_address>", "requiredCurrency": "INR", "nationality": "IN", "checkin": "2020-04-17", "checkout": "2020-04-18", "latitude": 25.270265579224, "longitude": 55.307498931885, "hotelCodes": [ "22014", "24312", "24313", "24315", "24369", "24370", "100272" ], "city_name": "London", "country_name": "United Kingdom", "radius": 20, "maxResult": 20, "occupancy": [ { "room_no": 1, "adult": 2, "child": 0, "child_age": [ 0 ] }, { "room_no": 2, "adult": 1, "child": 2, "child_age": [ 5, 7 ] } ] }
Otel Müsaitlik Araması
Otel Arama Sonuçları API'si, ilk Otel Arama API isteğinizde sağlanan belirli arama kriterlerine göre otel seçenekleri sunmak için tasarlanmıştır.
Bu API, konum, misafir sayısı (konaklayanlar) ve konaklama süresi (giriş ve çıkış tarihleri) dahil olmak üzere kriterlere uyan otellerin bir listesini döndürür. Otel Arama Sonuçları API'si tarafından üretilen her sonuç seti benzersiz bir token ile birlikte gelir. Bu token, sonraki aramalarda kaçırılan veya zaman aşımına uğramış sonuçları geri almak için önemlidir. Bir sonraki API isteğinizde `nextToken` değerini ekleyerek ilerleyen arama sonuçlarına sorunsuzca erişebilirsiniz.
Otel Arama İsteği
Yöntem | URL |
---|---|
POST | https://das.hotel.demircode.net/HotelAPI/hotel_search |
Otel Arama Elemanları
Elemant | Format | Açıklama | Gerekli |
---|---|---|---|
user_id | String | Kimlik doğrulama için kullanıcıya atanmış kimlik. | GEREKLİ |
user_password | String | Kullanıcı kimliği ile ilişkilendirilmiş şifre, güvenli erişim sağlar | GEREKLİ |
access | String | API işlevlerine giriş izni verir. | GEREKLİ |
ip_address | String | Web sitesine erişilen cihazın IP adresini yakalar. | GEREKLİ |
maxResult | Integer | Arama yanıtında döndürülecek maksimum sonuç sayısını tanımlar. | GEREKLİ |
latitude | Float | Coğrafi tabanlı aramalar için hedef konumun enlemini belirtir. | Coğrafi konum aramaları için GEREKLİ. |
longitude | Float | Coğrafi tabanlı aramalar için hedef konumun boylamını belirtir. | Coğrafi konum aramaları için GEREKLİ. |
hotelCodes | Array | Static Content API aracılığıyla alınabilecek otel kodlarının koleksiyonu, maksimum 1000 kod. | Otel kodu tabanlı aramalar için GEREKLİ. |
city_name | string | Şehir Adı API'sinden alınabilecek şehir adı. | Şehir tabanlı aramalar için GEREKLİ. |
country_name | string | Şehir Adı API'sinden alınabilecek ülke adı. | Şehir tabanlı aramalar için GEREKLİ. |
radius | integer | Arama için şehir merkezinden belirlenen yarıçap (kilometre cinsinden). | GEREKLİ |
occupancy | Array | Oda ve konaklayanların detaylarını içerir. | GEREKLİ |
room_no | Integer | Arama sorgusunda oda numarasını belirtir. | GEREKLİ |
adult | integer | Her oda için yetişkin sayısını listeler. | GEREKLİ |
child | integer | Her oda için çocuk sayısını listeler. | GEREKLİ |
child_age | Array | Her odadaki çocukların yaşlarını belirtir. | GEREKLİ |
checkin | Date | Giriş tarihi, YYYY-MM-DD formatında. | GEREKLİ |
checkout | Date | Çıkış tarihi, YYYY-MM-DD formatında. | GEREKLİ |
requiredCurrency | String | Dönen fiyatlar için 3 karakterli ISO para birimi kodu. | GEREKLİ |
requiredLanguage | String | Dönüş açıklamaları için dil kodu, Language API üzerinden alınabilir. | OPSİYONEL |
nationality | String | Ana misafirin milliyetini temsil eden Alpha-2 Ülke Kodları dizisi, fiyatları etkileyebilir. | GEREKLİ |
Sample Hotel Search Request
-
1 room, 2 adults and 0 child
{ "user_id": "<user_id>", "user_password": "<user_password>", "access": "Test", "ip_address": "<ip_address>", "requiredCurrency": "INR", "nationality": "IN", "checkin": "2020-04-17", "checkout": "2020-04-18", "latitude": 25.270265579224, "longitude": 55.307498931885, "hotelCodes": [ "22014", "24312", "24313", "24315", "24369", "24370", "100272" ], "city_name": "London", "country_name": "United Kingdom", "radius": 20, "maxResult": 20, "occupancy": [ { "room_no": 1, "adult": 2, "child": 0, "child_age": [ 0 ] } ] }
-
2 rooms, 1 room for 2 adults and 2 room for 1 adults and 2 children (5 and 7)
{ "user_id": "<user_id>", "user_password": "<user_password>", "access": "Test", "ip_address": "<ip_address>", "requiredCurrency": "INR", "nationality": "IN", "checkin": "2020-04-17", "checkout": "2020-04-18", "latitude": 25.270265579224, "longitude": 55.307498931885, "hotelCodes": [ "22014", "24312", "24313", "24315", "24369", "24370", "100272" ], "city_name": "London", "country_name": "United Kingdom", "radius": 20, "maxResult": 20, "occupancy": [ { "room_no": 1, "adult": 2, "child": 0, "child_age": [ 0 ] }, { "room_no": 2, "adult": 1, "child": 2, "child_age": [ 5, 7 ] } ] }
Yeni nesil Flight API900+ Havayolu Markası
