Fiyat Alma API’si

Otel fiyatlarınızı liste üzerinden API ile gönderin.

Çekme entegrasyon şeması

1. Bağlanırken, ortak Fiyat Alma API’si için URL’yi gönderir.

2. Ortak ayrıca isteğe bağlı olarak HTTP Temel kimlik doğrulama parametrelerini ve Canlı Fiyatlandırma API URL’sini sağlayabilir.

   Canlı Fiyatlandırma API’si ile şunları yapabilirsiniz:

   • Fiyat taleplerinde varsayılan değerden farklı bir misafir sayısı belirleyin (örneğin, 3 yetişkin + 1 çocuk, 10 yaşında).
   • Ortak, sorguda belirtilen zaman aşımı süresi içinde yanıt verirse, arama sırasında kullanıcıya yanıtı gösterin (3 saniyeye kadar).

3. Ortak, belirtilen API’ler için izin verilen maksimum yükü ve tek bir HTTP isteğinde sorgulanacak otel sayısını sağlar.

4. Saatte bir kez, robot, Fiyat Alma API’si için sağlanan URL’yi kullanarak varsayılan konaklama (2 yetişkin) için ortağın tekliflerini sorgular.

5. Fiyat Alma API’si, ortağın XML dosyasında listelenen tüm otelleri için mevcut tarihten itibaren en az 7 gün boyunca sorgulanır.

6. Fiyat Alma API’si, HTTP POST yöntemi kullanılarak bir Sorgu isteği gönderilerek sorgulanır.

Örnek istekler

Fiyat Alma API’sini sorgulamak için, Yandex robotu HTTP POST isteği verileri içinde bir Sorgu mesajı gönderir.

• Fiyat Alma API’sine basit bir Sorgu isteği örneği:

  
    <?xml version="1.0" encoding="UTF-8"?>
    <Query>
      <Checkin>2025-05-20</Checkin>
       <Nights>1</Nights>
       <PropertyList>
         <Property>HotelId123</Property>
         <Property>HotelId345</Property>
    ...
       </PropertyList>
    </Query>
  
  

• 3 yetişkin misafir ve 10 yaşında bir çocuk için, maksimum 3 saniye zaman aşımı ile Canlı Fiyatlandırma API’sine bir istek örneği:

  
    <?xml version="1.0" encoding="UTF-8"?>
    <Query latencySensitive="true">
      <DeadlineMs>3000</DeadlineMs>
      <Checkin>2025-05-20</Checkin>
      <Nights>1</Nights>
      <PropertyList>
        <Property>HotelId123</Property>
        <Property>HotelId345</Property>
         ...
      </PropertyList>
      <Context>
        <Occupancy>4</Occupancy>
        <OccupancyDetails>
         <NumAdults>3</NumAdults>
         <Children>
          <Child age="10"/>
         </Children>
       </OccupancyDetails>
     </Context>
    </Query>
  
  

Örnek yanıtlar

• Fiyat bilgisi içeren basit bir yanıt örneği:

  <?xml version="1.0" encoding="UTF-8"?>
  <Transaction>
    <Result>
     <Property>HotelId123</Property>
     <Checkin>2025-05-20</Checkin>
     <Nights>1</Nights>
     <Baserate currency="TRY">1430</Baserate>
     <Tax currency="TRY">70</Tax>
     <OtherFees currency="TRY">0</OtherFees>
     <Custom1>PrettyHotelName</Custom1>
    </Result>
  </Transaction>
  
  

• Satış noktası bağlantısı oluşturmak için veri içeren bir yanıt örneği:

  <?xml version="1.0" encoding="UTF-8"?>
  <Transaction>
  <Result>
    <Property>HotelId123</Property>
    <Checkin>2025-05-20</Checkin>
    <Nights>1</Nights>
    <Baserate currency="TRY">1430</Baserate>
    <Tax currency="TRY">70</Tax>
    <OtherFees currency="TRY">0</OtherFees>
    <Custom1>PrettyHotelName</Custom1>
    <AllowablePointsOfSale>
    	<PointOfSale id="default">
            <URL>https://online-agency.tr/booking?hotel=(CUSTOM1)&checkin=(CHECKINYEAR)(CHECKINMONTH)(CHECKINDAY)&checkout=(CHECKOUTYEAR)(CHECKOUTMONTH)(CHECKOUTDAY)&adults=(NUM-ADULTS)</URL>
        </PointOfSale>
    </AllowablePointsOfSale>
  </Result>
  </Transaction>
  

• Rezervasyon seçeneğinin istenen tarihte mevcut olmadığı bir yanıt örneği:

  <?xml version="1.0" encoding="UTF-8"?>
  <Transaction>
   <Result>
    <Property>HotelId123</Property>
    <Checkin>2025-06-25</Checkin>
    <Nights>1</Nights>
    <Baserate currency="TRY">-1</Baserate>
    <Tax currency="TRY">0</Tax>
    <OtherFees currency="TRY">0</OtherFees>
   </Result>
  </Transaction>