x
D E M İ R C O D E

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. 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. 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. 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. 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.

Yeni nesil Flight API900+ Havayolu Markası