Hotel Booking Request
The Book API allows you to create a hotel reservation for one or more priced rooms, specifying the number of guests for each room through an API.
Before using the Book API, you must call the Get Rate Rules API to ensure that the rooms are correctly priced or to gather the necessary information for the booking process.
The Book API also enables you to retrieve the booking status and details from the API.
Hotel Booking Request
Method | URL |
---|---|
POST | https://das.hotel.demircode.net/HotelAPI/hotel_book |
Hotel Booking Elements
Element | Format | Description | Required |
---|---|---|---|
sessionId | String | Indicates the session ID for which the search results were requested. This session ID must be used for the next API request. | REQUIRED |
productId | String | Unique ID of the product through which you want to book the hotel. This product ID can be obtained from the `productId` field in the Room Rates Results API's response. | REQUIRED |
tokenId | String | Use the TokenId that was returned in the Hotel Search Results API's response. | REQUIRED |
rateBasisId | String | Unique identifier provided by the supplier to identify the room for booking, as provided by the Check Rate Rules API. | REQUIRED |
clientRef | String | Client-generated booking reference number. | REQUIRED |
customerEmail | String | Email address of the customer. | REQUIRED |
customerPhone | String | Mobile number of the customer. | REQUIRED |
bookingNote | String | A booking number or reference code. | REQUIRED |
Additional Hotel Booking Elements
Element | Format | Description | Required |
---|---|---|---|
room_no | Integer | Specifies the room number | REQUIRED |
adult | Array | An array containing details about adults in the room. | REQUIRED |
title | Array | An array of titles for the adults. | REQUIRED |
firstName | Array | An array of first names for the adults. | REQUIRED |
lastName | Array | An array of last names for the adults | REQUIRED |
child | Array | An array containing details about children in the room. | |
title | Array | An array of titles for the child guests. | REQUIRED |
firstName | Array | An array of first names for the child guests. | REQUIRED |
lastName | Array | An array of last names for the child guests. | REQUIRED |
Sample Booking Request
-
1 room , 1st room for 2 adults
{ "sessionId":"TVRVNE1qSTJOelEzTVY4ME5UZGZNVEkxTGprNUxqSTBNUzR5TkE9PV8w", "productId":"trx101", "tokenId":"HTB0zd1QyPEeR3oIpmVn", "rateBasisId": "MTU3", "clientRef":"TDB85454", "customerEmail":"test@gmail.com", "customerPhone":"53453454334", "bookingNote":"Remark", "paxDetails":[ { "room_no":1, "adult":{ "title":["Mr","Mr"], "firstName":["test1","test2"], "lastName":["last1","last2"] } } ] }
-
2 rooms, 1st room for 2 adults and 2nd room for 1 adult 2 child
{ "sessionId":"TVRVNE1qSTJOelEzTVY4ME5UZGZNVEkxTGprNUxqSTBNUzR5TkE9PV8w", "productId":"trx101", "tokenId":"HTB0zd1QyPEeR3oIpmVn", "rateBasisId": "MTU3", "clientRef":"TDB85454", "customerEmail":"test@gmail.com", "customerPhone":"53453454334", "bookingNote":"Remark", "paxDetails":[ { "room_no":1, "adult":{ "title":["Mr","Mr"], "firstName":["test1","test2"], "lastName":["last1","last2"] } }, { "room_no":2, "adult":{ "title":["Mr"], "firstName":["test"], "lastName":["last"] }, "child":{ "title":["Mr","Mr"], "firstName":["test1","last1"], "lastName":["last1","last2"] } } ] }
Sample Booking Response
{ "status": "CONFIRMED", "supplierConfirmationNum": "HTL-ATE-205850", "referenceNum": 212, "clientRefNum": "TDB85454", "productId": "trx101", "roomBookDetails": { "hotelId": "882885", "checkIn": "2020-04-18", "checkOut": "2020-04-19", "days": 1, "currency": "INR", "NetPrice": "9961.28", "fareType": "Non-Refundable", "cancellationPolicy": "If Cancellation done from 2020-04-16 17:30:01 Cancellation charge would be INR 8558.16|t|If Cancellation done from 2020-04-17 01:30:01 Cancellation charge would be INR 0", "customerEmail": "test@gmail.com", "customerPhone": "53453454334", "rooms": [ { "name": "STANDARD ROOM", "description": "STANDARD ROOM", "boardType": "Room Only", "paxDetails": { "name": [ "Mr test1 last1", "Mr test1 last2" ] } } ] }, "error": "" }
Booking Response Elements
Element | Format | Description |
---|---|---|
status | String | Indicates the booking status. |
supplierConfirmationNum | String | Confirmation number received from the API for the booking. |
referenceNum | String | Reference number received from the API for the booking. |
clientRefNum | String | Specifies the client reference number that was included in the booking request. |
productId | String | Unique ID of the product through which you booked the hotel. |
roomBookDetails | Array | Contains all information including room, hotel, and passenger details |
Otel Rezervasyon İsteği
Rezervasyon API'si, bir veya daha fazla fiyatlandırılmış oda için, her oda için belirtilen misafir sayısını kullanarak bir otel rezervasyonu yapmanızı sağlar.
Rezervasyon API'sini kullanmadan önce, odaların doğru fiyatlandırıldığından emin olmak veya rezervasyon süreci için gerekli bilgileri toplamak için Fiyat Kuralları API'sini çağırmanız gerekir.
Rezervasyon API'si ayrıca API'den rezervasyon durumunu ve ayrıntılarını almanızı sağlar.
Otel Rezervasyon İsteği
Yöntem | URL |
---|---|
POST | https://das.hotel.demircode.net/HotelAPI/hotel_book |
Otel Rezervasyon Elemanları
Eleman | Format | Açıklama | Gerekli |
---|---|---|---|
sessionId | String | Arama sonuçlarının istendiği oturum kimliğini belirtir. Bu oturum kimliği bir sonraki API isteği için kullanılmalıdır. | GEREKLİ |
productId | String | Otel rezervasyonu yapmak istediğiniz ürünün benzersiz kimliği. Bu ürün kimliği, Oda Fiyatları Sonuçları API'sinin yanıtındaki `productId` alanından alınabilir. | GEREKLİ |
tokenId | String | Otel Arama Sonuçları API'sinin yanıtında döndürülen TokenId'yi kullanın. | GEREKLİ |
rateBasisId | String | Rezervasyon için odayı tanımlamak üzere tedarikçi tarafından sağlanan benzersiz kimlik, Fiyat Kuralları API'si tarafından sağlanmıştır. | GEREKLİ |
clientRef | String | Müşteri tarafından oluşturulan rezervasyon referans numarası. | GEREKLİ |
customerEmail | String | Müşterinin e-posta adresi. | GEREKLİ |
customerPhone | String | Müşterinin telefon numarası | GEREKLİ |
bookingNote | String | Bir rezervasyon numarası veya referans kodu. | GEREKLİ |
Ek Otel Rezervasyon Elemanları
Eleman | Format | Açıklama | Gerekli |
---|---|---|---|
room_no | Integer | Oda numarasını belirtir. | GEREKLİ |
adult | Array | Odada bulunan yetişkinlerin detaylarını içeren bir dizi. | GEREKLİ |
title | Array | Yetişkinler için unvanların bir dizisi. | GEREKLİ |
firstName | Array | Yetişkinlerin isimlerinin bir dizisi. | GEREKLİ |
lastName | Array | Yetişkinlerin soyadlarının bir dizisi. | GEREKLİ |
child | Array | Odada bulunan çocukların detaylarını içeren bir dizi. | |
title | Array | Çocuk misafirler için unvanların bir dizisi | GEREKLİ |
firstName | Array | Çocuk misafirlerin isimlerinin bir dizisi. | GEREKLİ |
lastName | Array | Çocuk misafirlerin soyadlarının bir dizisi. | GEREKLİ |
Örnek Rezervasyon Talebi
-
1 room , 1st room for 2 adults
{ "sessionId":"TVRVNE1qSTJOelEzTVY4ME5UZGZNVEkxTGprNUxqSTBNUzR5TkE9PV8w", "productId":"trx101", "tokenId":"HTB0zd1QyPEeR3oIpmVn", "rateBasisId": "MTU3", "clientRef":"TDB85454", "customerEmail":"test@gmail.com", "customerPhone":"53453454334", "bookingNote":"Remark", "paxDetails":[ { "room_no":1, "adult":{ "title":["Mr","Mr"], "firstName":["test1","test2"], "lastName":["last1","last2"] } } ] }
-
2 rooms, 1st room for 2 adults and 2nd room for 1 adult 2 child
{ "sessionId":"TVRVNE1qSTJOelEzTVY4ME5UZGZNVEkxTGprNUxqSTBNUzR5TkE9PV8w", "productId":"trx101", "tokenId":"HTB0zd1QyPEeR3oIpmVn", "rateBasisId": "MTU3", "clientRef":"TDB85454", "customerEmail":"test@gmail.com", "customerPhone":"53453454334", "bookingNote":"Remark", "paxDetails":[ { "room_no":1, "adult":{ "title":["Mr","Mr"], "firstName":["test1","test2"], "lastName":["last1","last2"] } }, { "room_no":2, "adult":{ "title":["Mr"], "firstName":["test"], "lastName":["last"] }, "child":{ "title":["Mr","Mr"], "firstName":["test1","last1"], "lastName":["last1","last2"] } } ] }
Örnek Rezervasyon Yanıtı
{ "status": "CONFIRMED", "supplierConfirmationNum": "HTL-ATE-205850", "referenceNum": 212, "clientRefNum": "TDB85454", "productId": "trx101", "roomBookDetails": { "hotelId": "882885", "checkIn": "2020-04-18", "checkOut": "2020-04-19", "days": 1, "currency": "INR", "NetPrice": "9961.28", "fareType": "Non-Refundable", "cancellationPolicy": "If Cancellation done from 2020-04-16 17:30:01 Cancellation charge would be INR 8558.16|t|If Cancellation done from 2020-04-17 01:30:01 Cancellation charge would be INR 0", "customerEmail": "test@gmail.com", "customerPhone": "53453454334", "rooms": [ { "name": "STANDARD ROOM", "description": "STANDARD ROOM", "boardType": "Room Only", "paxDetails": { "name": [ "Mr test1 last1", "Mr test1 last2" ] } } ] }, "error": "" }
Rezervasyon Yanıt Elemanları
Eleman | Format | Açıklama |
---|---|---|
status | String | Rezervasyon durumunu belirtir. |
supplierConfirmationNum | String | Rezervasyon için API'den alınan onay numarası. |
referenceNum | String | Rezervasyon için API'den alınan referans numarası. |
clientRefNum | String | Rezervasyon isteğinde belirtilen müşteri referans numarasını belirtir. |
productId | String | Otel rezervasyonu yaptığınız ürünün benzersiz kimliği. |
roomBookDetails | Array | Oda, otel ve yolcu detayları dahil olmak üzere tüm bilgileri içerir. |