Canlı demo

Konaklama API

Oteller, apartlar ve tatil kiralıkları için Konaklama API

Konaklama API, her türlü konaklamayı rezervasyon sitenize taşır: otel odaları, servisli apartlar, tatil evleri, hosteller ve pansiyonlar. Bu sayfa, bir konaklamanın arkasındaki veriyi, kiralıkları otellerden ayıran kuralları ve PHPTRAVELS'ın kendi tesislerinizi ve tedarikçi stokunu tek aramada nasıl sattığını anlatır.

  • Tesis, birim, fiyat planı, takvim
  • Asgari konaklama ve ücretler
  • İptal pencereleri
  • Kendi stokunuz ve API arzı

Veri modeli

Her konaklamanın içinde dört katman

300 odalı bir otel de olsa, tek bir plaj evi de olsa, konaklama API'si onu aynı dört iç içe katmanla tanımlar. Her katman, misafirin rezervasyondan önce sorduğu farklı bir soruyu yanıtlar.

01Tesis

Mekanın kendisi: ad, tür, adres ve harita konumu, fotoğraflar, olanaklar, yıldız veya kalite puanı, konaklama kuralları ve giriş saatleri.

property_id · type · address · geo · photos · amenities · check_in_from

02Oda veya birim

Gerçekten rezerve edilen şey: bir oda tipi, bütün bir daire veya yatakhanede bir yatak; büyüklüğü, yatakları ve azami kişi sayısıyla.

unit_id · beds · size_m2 · max_adults · max_children

03Fiyat planı

Bu birimin nasıl satıldığı: pansiyon türü, iptal politikası, ödeme koşulları ve kimin rezervasyon yapabileceği, örneğin herkes veya yalnızca acenteler.

rate_plan_id · board · cancel_policy · payment · channel

04Müsaitlik

Gece başına bir satır: fiyat, kalan birim sayısı, asgari konaklama ve o gün girişe veya çıkışa izin verilip verilmediği.

date · price · units_left · min_stay · closed_to_arrival

Tek bir konaklama ilanının ayrı üst üste katmanlar olarak çizilmiş bina, oda, fiyat etiketi ve takvim hali

PHPTRAVELS konaklama modülüne Stays der, çünkü aynı model otellerin çok ötesini kapsar. Bir tesisin birimleri vardır, bir birim bir veya daha fazla fiyat planıyla satılır ve her fiyat planının gece gece fiyat ve müsaitlik takvimi bulunur. Bu dört katmanı doğru kurarsanız hosteldeki bir yatak, otelde bir süit ve üç yatak odalı bir villa aynı arama ve ödeme akışına sığar.

Tedarikçiler katmanları farklı adlandırır, bazıları ikisini birleştirir; ancak yapı her zaman vardır. Konaklama, her kaynağı bu yapıya eşler ve misafir tutarlı tek bir sayfa görür.

Gece gece

Konaklamalar müsaitlik takviminde kazanılır veya kaybedilir

Her konaklama API'si bir takvimde biter. Arama, bir tesisi yalnızca istenen konaklamanın her gecesi açık, fiyatlı ve konaklama kurallarına uygunsa döndürür.

İki yatak odalı daire · Standart fiyatKasım 2026 · Gecelik fiyat
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Açık, gecelik fiyatlı
  • Zaten rezerve edilmiş
  • Sahibi tarafından kapatılmış
  • Bu girişten itibaren asgari konaklama
  • Girişe kapalı

Örnek veri, sadeleştirilmiştir

  • Fiyatlar geceliktirKonaklama toplamı her gecenin toplamıdır; dolayısıyla hafta sonu fiyatıyla cuma ve cumartesi, iki hafta içi geceden pahalıdır. Gün ve sezon fiyatları tesiste değil, takvimde tutulur.
  • Asgari konaklama kurallarıCuma girişinde üç gece asgari şartı, birimi iki gecelik aramadan gizler. Kiralıklar bu kuralları otellerden çok daha fazla kullanır; hafta sonları ve yüksek sezonda genellikle daha katıdır.
  • Girişe veya çıkışa kapalıBir gece daha uzun bir konaklamanın parçası olarak rezerve edilebilir, ama ilk veya son gece olarak edilemez. Tatil evlerindeki değişim günleri böyle çalışır.
  • Kapalı geceler ve stop-sellSahipler kendi kullanımları veya bakım için tarihleri bloke eder, stop-sell ise birimi anında satıştan çeker. İstenen tarihler içindeki tek bir kapalı gece bile birimi sonuçlardan çıkarır.

Her konaklama otel değildir

Oteller, apartlar ve tatil kiralıkları

Veri modeli ortaktır, ancak her konaklama türü onu farklı doldurur. Otel odasından fazlasını sattığınızda rezervasyon akışınızın karşılaması gereken farklar şunlardır.

Oteller

Hosteller ve pansiyonlar dahil

Neyin rezerve edildiği
Çok sayıda aynı odası olan bir oda tipi veya ortak yatakhanede bir yatak.
Fiyatlandırma
Oda ve pansiyon türüne göre gecelik fiyat; ek yetişkin veya çocuk fiyatı değiştirebilir.
Konaklama kuralları
Asgari konaklama yalnızca yoğun tarihlerde; çoğu gece tek başına rezerve edilebilir.
Ücretler ve depozitolar
Şehir veya turizm vergisi, bazen tesiste ödenen bir tatil köyü ücreti.
Varış
24 saat açık veya görevli bir resepsiyon; vouchera yazılan giriş saatleri yeterlidir.
Tipik kaynak
Bedbank'lar ve toptancılar, doğrudan sözleşmeler, kanal yöneticileri.

Servisli apartlar

Apart oteller ve şehir daireleri

Neyin rezerve edildiği
Çoğunlukla mutfaklı ve ayrı yatak odalı bir birim tipi.
Fiyatlandırma
Birim başına gecelik fiyat; uzun konaklamalar için haftalık veya aylık fiyatlar.
Konaklama kuralları
Asgari konaklama yaygındır ve uzun konaklamalar talebin büyük bir kısmını oluşturur.
Ücretler ve depozitolar
Konaklama başına temizlik ücreti ve iade edilebilir depozito yaygındır.
Varış
Resepsiyon saatleri değişir; geç varışlar için anahtar kutusu veya kod gerekir.
Tipik kaynak
Kanal yöneticileri, doğrudan sözleşmeler ve bazı toptancılar.

Tatil kiralıkları

Tatil evleri, villalar ve kulübeler

Neyin rezerve edildiği
Belirli bir ev. Genellikle bundan yalnızca bir tane vardır.
Fiyatlandırma
Evin tamamı için gecelik fiyat ve temel kişi sayısını aşan her misafir için ek ücret.
Konaklama kuralları
Asgari konaklama, sabit değişim günleri ve girişe kapalı tarihler olağandır.
Ücretler ve depozitolar
Temizlik ücreti, iade edilebilir hasar depozitosu ve yerel vergiler; her biri ödemeden önce gösterilir.
Varış
Giriş talimatları, adres ve iletişim varıştan önce gönderilir, herkese açık sayfada asla yer almaz.
Tipik kaynak
Sahipler ve mülk yöneticileri; doğrudan veya bir kanal yöneticisi aracılığıyla.

Kendi sözleşmeleriniz yerine birçok ev sahibinin evlerini mi satıyorsunuz? Bu bir pazaryeridir ve BnB portalı sayfasında ele alınır.

İptal politikası pencereleri

Tek rezervasyon, üç iptal penceresi

İptal politikası, varış tarihinden geriye doğru sayılan bir zaman çizelgesidir. Her pencere, misafir o pencerede iptal ederse neyi geri alacağını belirler.

RezervasyonGiriş
  1. 01 · Varıştan 14 gün öncesine kadarÜcretsiz iptalMisafir iptal eder ve tam iade alır. Yolcuların ilk baktığı son tarih budur; bu yüzden kural olarak değil, tarih olarak gösterin.
  2. 02 · 14 ile 3 gün öncesi arasıKısmi cezaGenellikle ilk gece veya konaklamanın belirli bir yüzdesi kadar ceza uygulanır. Kiralıklar bu pencerede depozitoyu tutabilir.
  3. 03 · Son 3 gün ve gelmemeİade edilmezTutarın tamamı alıkonur. İade edilmez olarak satılan fiyat planları, rezervasyon anından itibaren bu pencerede başlar.
Örnek pencereler; her fiyat planının kendi pencereleri vardır.
  • Tesise değil, fiyat planına göreAynı daire hem esnek hem de daha ucuz, iade edilemez bir fiyata sahip olabilir; bu yüzden politika fiyat planı katmanına aittir.
  • Tarihler tesisin saat diliminde"14 gün önce", tesisin bulunduğu yerdeki varış tarihinden itibaren sayılır. Bunu sayfada ve voucherda net bir tarih ve saate çevirin.
  • Tedarikçinin politikası geçerlidirAPI stokunda tedarikçinin verdiğinden daha esnek koşullar sunamazsınız. Kendi sözleşmelerinizle pencereleri kendiniz belirlersiniz.

Kendi stokunuz ve API stoku

Sözleşmeli tesisleriniz ve tedarikçi API'leri tek aramada

Çoğu konaklama satıcısı ikisini de yapar: kendi sözleşmeli yerlerini yükler, gerisi için tedarikçi API'leri ekler. Yolcu, bir konaklamanın nereden geldiğini asla fark etmemelidir.

Kendi tesisleriniz

  • Yönetim panelinde tesisleri, birimleri ve fiyat planlarını kendiniz yükleyin
  • Sahiplere ve otellere takvimlerini yönetmeleri için extranet girişi verin
  • Fiyatları, asgari konaklamayı, kapalı tarihleri ve iptal pencerelerini belirleyin
  • Bırakma günleri ve stop-sell içeren kontenjanlar
  • Veya fiyat ve müsaitliği bir kanal yöneticisinden alın

Tedarikçi API stoku

  • Kendiniz sözleşme yapamayacağınız destinasyonlarda geniş kataloglar
  • Arama anında canlı fiyat ve müsaitlik
  • Her fiyatta tedarikçinin pansiyon türü, politikaları ve ücretleri
  • Kendi tedarikçi sözleşmeniz ve kimlik bilgilerinizle devreye alınır
  • Rezervasyon ve iptal doğrudan tedarikçiye gönderilir

Misafirin elde ettiği

  • Tek sonuç listesi ve her yer için tek tesis sayfası
  • Birden çok kaynaktaki aynı oda, sizin fiyatınızla bir kez gösterilir
  • Tedarikçiye, destinasyona veya kanala göre kâr marjlarınız ve B2B acente fiyatları
  • Hangi kaynak onaylarsa onaylasın tek voucher biçimi

Kanal yöneticisi bağlama Kanal yöneticisi entegrasyonu sayfasında anlatılır. Sözleşmeyle elinizde tuttuğunuz odalar için Rezervasyon envanter sistemi sayfasına bakın.

PHPTRAVELS'ta hazır

Bağlı konaklama tedarikçileri

Bu konaklama tedarikçileri bugün Stays modülüne bağlıdır. Tedarikçiyle sözleşme imzalar, kendi kimlik bilgilerinizi yönetim paneline girer, sandbox ortamında test eder ve yayına alırsınız. Liste, entegrasyon dizinimizden canlı olarak gelir.

Listede olmayan bir tedarikçiye, örneğin bölgesel bir kiralama ağına mı ihtiyacınız var? Dokümantasyonu olan her konaklama API'si eklenebilir, bkz. Özel API entegrasyonu. Otel tedarikçi türleri ve içerik eşleştirme için Otel API sayfasını, en büyük iki bedbank rehberi için RateHawk API entegrasyonu ve Hotelbeds API entegrasyonu sayfalarını okuyun.

Misafirlerinizin yapacağı gibi bir konaklama rezerve edin

Canlı demoda arayın, fiyatları karşılaştırın ve rezervasyon yapın; ardından hangi tesisleri ve tedarikçileri satmayı planladığınızı bize söyleyin.

Canlı demoyu deneyinTedarikçilerinizi sorun

Kendi uygulamanızı veya iş ortağı beslemenizi mi geliştiriyorsunuz? PHPTRAVELS REST API, bağlı tüm konaklama kaynaklarını tek biçimde sunar ve rezervasyon olayları için webhook'lar içerir. Enterprise planla birlikte gelir, bkz. Fiyatlandırma ve geliştirici dokümantasyonu. Daha geniş resim Seyahat API'leri sayfasındadır.

SSS

Konaklama API: geliştiricilerin ve acentelerin soruları

Satış ekibiyle görüşün

Konaklama API, bir rezervasyon sitesinin konaklama araması yapmasını, belirli tarih ve kişi sayısı için fiyat ve müsaitliği okumasını, rezervasyon oluşturup görüntülemesini ve iptal etmesini sağlayan web servisleri kümesidir. Oteller ve her türlü diğer konaklamayı kapsar: apartlar, tatil kiralıkları, hosteller ve pansiyonlar.

Temel çağrılar aynıdır. Konaklama API'si ayrıca otel dışı konaklamaların ihtiyaç duyduklarını da yönetmelidir: bütün birimin rezervasyonu, asgari konaklama ve değişim günleri, ek misafir ücretleri, temizlik ücretleri, iade edilebilir depozitolar ve varıştan önce gönderilen giriş talimatları.

Evet. PHPTRAVELS'ta Stays modülü her konaklama türü için tesis, birim, fiyat planı ve müsaitlikten oluşan tek bir model kullanır; böylece oteller, apartlar ve tatil evleri kendi kurallarıyla aynı aramada görünür.

Takvimdeki her gece, genellikle varış tarihine bağlı bir asgari konaklama süresi taşıyabilir. Misafir asgari süreden az gece ararsa birim döndürülmez. Girişe kapalı ve çıkışa kapalı işaretleri de değişim günleri için aynı şekilde çalışır.

Evet. Tesisleri, birimleri, fiyat planlarını ve takvimleri kendiniz ekleyebilir, sahiplere extranet girişi verebilir veya fiyatları bir kanal yöneticisinden alabilir ve hepsini tedarikçi stokunun yanında tek sonuç listesinde satabilirsiniz.

Fiyat planından. Tedarikçi stoku tedarikçinin politikasını taşır, kendi tesisleriniz ise sizin belirlediğiniz pencereleri kullanır. Son tarih, ödemeden önce misafire gösterilir ve voucher üzerine basılır.

Hayır. Her konaklama tedarikçisiyle kendiniz sözleşme imzalar ve kendi kimlik bilgilerinizi yönetim paneline girersiniz. PHPTRAVELS rezervasyon platformunu, Stays modülünü ve hazır bağlayıcıları sağlar.

Evet. Enterprise planda PHPTRAVELS REST API, bağlı tüm kaynaklardaki arama ve rezervasyonu tek biçimde sunar; rezervasyon olayları için webhook'lar ve genişletmeniz için tam kaynak kodu da gelir.

Bir PHPTRAVELS lisansı, kendi alan adınız ve en az bir stok kaynağı: kendi sözleşmeli tesisleriniz, bir kanal yöneticisi veya bir konaklama toptancısıyla tedarikçi sözleşmesi. Canlı demo, tüm akışı önce gösterir.

Keşfetmeye devam edin

Platform hakkında daha fazlası