Canlı demo

Otel tedarikçisi entegrasyonu

Hotelbeds API entegrasyonu: içerik, eşleştirme ve canlı rezervasyon

Bir Hotelbeds API entegrasyonu tek değil, iki iştir. Önce otel içeriğini indirip saklarsınız, ardından canlı fiyatlar üzerinden rezervasyon yaparsınız. PHPTRAVELS ikisini de otel modülünde, kendi Hotelbeds sözleşmeniz ve anahtarlarınızla yapar.

  • Content API senkronizasyonu
  • Booking API akışı
  • BOOKABLE ve RECHECK fiyatları
  • Otel eşleştirme

Hotelbeds API'leri nasıl birlikte çalışır

Hotelbeds API entegrasyonu: bir yanda içerik, diğer yanda rezervasyon

Hotelbeds otel API'lerini ikiye ayırır. Content API statik veri döndürür: açıklamalar, görseller, olanaklar, pansiyon tipleri ve odalar. Booking API canlı müsaitlik ve fiyatları döndürür ve rezervasyonu alır. Hangi çağrıları kullandığını görmek için ortadaki bir adımı seçin.

Content API

Statik, sizin tarafınızda saklanır
  • Otel listesihotels · from=1&to=1000Portföyünüzdeki tüm oteller, istek başına en fazla 1.000 otellik sayfalar halinde.
  • Olanaklar, pansiyon tipleri ve odalarfacilities · boards · roomsBooking API kodlarını misafirlerinizin anlayacağı kelimelere çeviren kod tabloları.
  • Görsellerphotos.hotelbeds.com/giata/İhtiyacınız olan boyutta Hotelbeds fotoğraf sunucusuyla birleştirilen kısmi görsel yolları.
  • Günlük değişikliklerlastUpdateTimeİlk yüklemeden sonra lastUpdateTime ile günde bir istek yalnızca değişenleri döndürür.

İstek akışı

Booking API

Canlı, her misafir için çağrılır
  • MüsaitlikPOST /hotelsOtel kodlarınız, tarihleriniz ve kişi sayısı için odalar, pansiyon tipleri, fiyatlar ve iptal ücretleri.
  • Fiyat kontrolüPOST /checkratesRECHECK olarak işaretlenmiş bir fiyat için güncel tutar ve koşullar, ayrıca upselling seçenekleri.
  • RezervasyonPOST /bookingsSeçilen rateKey'i rezervasyon sahibi ve misafir adlarıyla onaylar ve referans numarasını döndürür.
  • İptalDELETE /bookings · simulateÜcreti göstermek için iptali simüle eder veya rezervasyonu gerçekten iptal eder.
Örnek ekran. Çağrılar developer.hotelbeds.com belgelerindeki gibidir; akış PHPTRAVELS'ın bunları nasıl kullandığını gösterir.

Başarısız Hotelbeds projelerinin çoğu iki tarafı birbirine karıştırır. Misafir arama yaparken Content API'yi çağırırlar; bu yavaştır ve Hotelbeds'in uyardığı gibi kimlik bilgilerinizin engellenmesine yol açabilir. Ya da saklanmış kodlar olmadan canlı arama yaparlar ve görselleri veya olanakları gösteremezler. PHPTRAVELS iki tarafı ayrı tutar: içerik arka planda senkronize edilir ve misafir beklerken yalnızca müsaitlik, fiyat kontrolü ve rezervasyon çağrıları çalışır.

Tedarikçinin kendisi, ürünleri ve hesap açma süreci hakkında bilgi almak isterseniz Hotelbeds tedarikçi profili sayfasını okuyun. Bu sayfa teknik entegrasyonla ilgilidir.

Fiyat türleri

Ödeme sürecinizi değiştiren dört fiyat alanı

Her Hotelbeds fiyatı, hemen rezervasyon yapıp yapamayacağınızı, hangi fiyatı gösterebileceğinizi ve parayı kimin tahsil edeceğini belirleyen birkaç özellik taşır. Motorunuzun her sonuçta okuması gereken alanlar bunlardır.

AlanBirinci durumİkinci durumPHPTRAVELS ne yapar

Rezerve edilebilir veya kontrol gerekli

rateType		BOOKABLE

Fiyat günceldir. Başka bir çağrı yapmadan rezervasyon yapabilirsiniz.

RECHECK

Güncel fiyat ve koşulları almak için önce fiyat kontrolünü çağırmanız gerekir.

RECHECK fiyatlarında ödeme adımından önce fiyat kontrolü yapar ve her değişikliği misafire gösterir.

Net veya komisyonlu

net · sellingRate		net

Net model: fiyatlar nettir, bu yüzden kendi kâr marjınızı eklersiniz.

sellingRate

Komisyonlu model: komisyon zaten sellingRate içindedir ve bu fiyat nihaidir.

Net fiyatlara kendi kâr kurallarınızı uygular, komisyonlu fiyatları sellingRate üzerinden satar.

Sabit satış fiyatı

hotelMandatory		true

hotelMandatory true ise: sellingRate üzerinden satmanız gerekir.

false · null

Net fiyatta false veya boş ise: kendi kâr marjınızı belirleyebilirsiniz.

Otel zorunlu kıldığında, kâr kuralı ne olursa olsun gösterilen fiyatı sellingRate'e sabitler.

Misafir ne zaman öder

paymentType		AT_WEB

Ödeme, rezervasyon sırasında sitenizden tahsil edilir.

AT_HOTEL

Misafir ödemeyi doğrudan otele yapar.

Fiyatı şimdi öde veya otelde öde olarak etiketler ve ödeme sürecini buna göre yönlendirir.

Hangi fiyatlandırma modelini alacağınız Hotelbeds sözleşmenize bağlıdır. Hotelbeds'in belirttiği gibi, satış yöneticiniz işletmeniz için uygun modeli önerir.

Otel eşleştirme

Hotelbeds otellerini zaten sattığınız otellerle eşleştirin

Kendi sözleşmeleriniz veya ikinci bir tedarikçiniz varsa aynı otel farklı kodlarla gelir. Eşleştirme bunları birbirine bağlar; böylece misafir üç kopya yerine en iyi fiyatlı tek bir otel görür.

PHPTRAVELS'ta eşleştirme nasıl çalışır

Her içerik senkronizasyonundan sonra PHPTRAVELS, Hotelbeds otellerini ad, adres, şehir ve koordinatlara göre otel listenizle karşılaştırır. Yakın eşleşmeler otomatik olarak bağlanır. Şüpheli olanlar bir kişinin onayını bekler, eşleşmesi olmayan oteller ise yeni tesis olarak içe aktarılabilir veya yok sayılabilir.

Eşleştirilen oteller Konaklama modülünde tek bir sayfayı, galeriyi ve yorum puanını paylaşırken her tedarikçi kendi fiyatlarını ve kurallarını korur. Aynı eşleştirme herkese açık sitenizde ve B2B seyahat portalı içinde kullanılır.

Otel eşleştirme
  • Harbour View HotelLizbon48291397%Eşleşti
  • Old Town SuitesPrag11735492%Eşleşti
  • Palm Court ResortDubai66201874%İncele
  • Casa Azul BoutiqueSevilla–0%Eşleşme yok
  • Northern Lights LodgeTromsø90522766%İncele
  • Riverside ApartmentsBudapeşte33076198%Eşleşti

Uydurma otel ve kodlarla örnek ekran.

Hotelbeds XML veya JSON

Her istek imzalanır ve testler küçük başlar

Ekipler hâlâ Hotelbeds XML diye arama yapıyor, ancak güncel belgeler JSON istekleri gösteriyor. Her iki durumda da aynı işlemler söz konusudur ve her istek iki başlık taşır.

availability-request.sh (örnek)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
İki başlık
Anahtarınızı içeren Api-key ve X-Signature: anahtarınızın, gizli anahtarınızın ve saniye cinsinden geçerli zamanın SHA256 özeti.
Test sunucusu
Hotelbeds'in belirttiği gibi test sunucuları canlı ortamla aynıdır, ancak oradaki rezervasyonlar gerçek değildir ve kartlardan ödeme alınmaz.
Günde 50 istek
Yeni anahtarlar, günde 50 istek kotalı bir değerlendirme ortamı açar. Sertifikasyonla birlikte kota artar.
Canlı içerik çağrısı yok
Hotelbeds, Content API'yi gerçek zamanlı çağırmanın kimlik bilgilerinin engellenmesine yol açabileceği konusunda uyarır. PHPTRAVELS bunu asla yapmaz.

İçerik senkronizasyon planlayıcı

Otel listenizin kaç Content API çağrısına ihtiyacı var

Hotelbeds'in belirttiği gibi otel listesi en fazla 1.000 otellik sayfalar halinde gelir ve ilk yüklemeden sonra lastUpdateTime ile yapılan günlük istek yalnızca değişiklikleri döndürür. Senkronizasyonu planlamak için rakamlarınızı girin.

İlk tam yükleme için istek sayısı
20
Günlük güncelleme başına istek sayısı
3
Değerlendirme kotasıyla bir tam yükleme için gün sayısı
1

Yalnızca otel listesi için bir tahmindir. Kod tabloları ve görseller birkaç çağrı daha ekler. Günde 50 isteklik değerlendirme kotasında önce tek bir destinasyonla test edin.

Canlıya geçiş kontrol listesi

Canlıya geçmeden önce neleri hazır etmelisiniz

Hotelbeds, paneli üzerinden sizi değerlendirmeden sertifikasyona, ardından canlı anahtarlara taşır. Bir Hotelbeds API entegrasyonunun önce kapsaması gereken noktalar ve PHPTRAVELS'ın bunları nasıl karşıladığı aşağıdadır.

  • Değerlendirme anahtarları yönetim paneline eklendi, test sunucusu seçildi
  • Content API veritabanınızla senkronize edildi, günlük güncelleme planlandı
  • Oteller listenizle eşleştirildi, şüpheli eşleşmeler incelendi
  • RECHECK fiyatları ödemeden önce fiyat kontrolünden geçiyor
  • hotelMandatory true olduğunda sellingRate'e uyuluyor
  • Fiyat notları ve iptal ücretleri misafir ödeme yapmadan önce gösteriliyor
  • Voucher, Hotelbeds referansını ve fiyat notlarını gösteriyor
  • İptal önce simüle ediliyor, sonra onaylanıyor ve ücret kaydediliyor

Sertifikasyon adımları ve canlı erişim, sözleşmenize ve pazarınıza göre Hotelbeds tarafından belirlenir.

Maliyet

Motor için tek lisans, Hotelbeds ile kendi sözleşmeniz

PHPTRAVELS, kaynak koduyla birlikte gelen tek seferlik bir lisanstır. Hotelbeds ise sizinle Hotelbeds arasında ayrı bir anlaşmadır; böylece net fiyatlar ve anahtarlar sizde kalır.

Startup
Tek seferlik lisans
tek seferlik lisans
Agency
Tek seferlik lisans
tek seferlik lisans
Enterprise
Tek seferlik lisans
tek seferlik lisans

Hotelbeds, yan yana kullanabileceğiniz birkaç otel kaynağından biridir. seyahat API'leri genel bakışında RateHawk ile nasıl birlikte çalıştığını görün veya XML tedarikçi listesi sayfasında tedarikçileri karşılaştırın.

Fiyatları görünOtel demosunu deneyin

SSS

Hotelbeds API entegrasyonu hakkında sorular

Geliştiricilerin ve seyahat şirketlerinin Hotelbeds'i bağlamadan önce sorduğu sorular.

Satış ekibiyle görüşün

İki bölüm. Otelleri, görselleri, olanakları, pansiyon tiplerini ve odaları veritabanınıza kaydeden, Content API ile arka planda çalışan bir senkronizasyon ve müsaitlik, fiyat kontrolü, rezervasyon ve iptal için Booking API ile canlı bir akış. PHPTRAVELS ikisini de otel modülünde çalıştırır.

Birçok kişi hâlâ Hotelbeds XML der, ancak güncel Hotelbeds belgeleri JSON istek ve yanıtları gösterir. İşlemler her iki durumda da aynıdır ve PHPTRAVELS formatı sizin yerinize yönetir.

BOOKABLE fiyat zaten günceldir ve hemen rezerve edilebilir. RECHECK fiyat ise önce güncel fiyatı ve koşulları döndüren bir fiyat kontrolü çağrısı gerektirir. PHPTRAVELS bu çağrıyı ödeme adımından önce yapar.

Yavaştır ve Hotelbeds, Content API'nin gerçek zamanlı kullanımının kimlik bilgilerinin engellenmesine yol açabileceği konusunda uyarır. İçerik sayfalar halinde indirilmeli, saklanmalı ve lastUpdateTime ile günde bir kez güncellenmelidir. PHPTRAVELS tam olarak böyle çalışır.

Evet. Hotelbeds'e kaydolur, sözleşmeyi imzalar ve kendi API anahtarınızı ve gizli anahtarınızı alırsınız. Yeni anahtarlar, sertifikasyonu tamamlayana kadar günde 50 isteklik bir değerlendirme ortamında çalışır.

Evet. Otel eşleştirme aynı tesisi kaynaklar arasında bağlar; böylece misafirler mevcut en iyi fiyatla tek bir otel görür, her kaynak ise kendi kâr marjını ve kurallarını korur.

PHPTRAVELS paketleri, kaynak koduyla birlikte tek seferlik lisans olarak fiyatından başlar. Hotelbeds sözleşmeniz ayrıdır ve doğrudan Hotelbeds ile yapılır. Fiyatlandırma sayfasına göz atın veya satış ekibinden teklif isteyin.

Keşfetmeye devam edin

Platform hakkında daha fazlası