Demo langsung

Integrasi pembekal hotel

Integrasi Hotelbeds API: kandungan, pemetaan dan tempahan langsung

Integrasi Hotelbeds API ialah dua tugas, bukan satu. Anda memuat turun dan menyimpan kandungan hotel, kemudian membuat tempahan berdasarkan kadar langsung. PHPTRAVELS melakukan kedua-duanya dalam modul hotel, dengan kontrak dan kunci Hotelbeds anda sendiri.

  • Penyegerakan Content API
  • Aliran Booking API
  • Kadar BOOKABLE dan RECHECK
  • Pemetaan hotel

Cara API Hotelbeds saling berkait

Integrasi Hotelbeds API: kandungan di satu pihak, tempahan di pihak lain

Hotelbeds membahagikan API hotelnya kepada dua. Content API memulangkan data statik: penerangan, imej, kemudahan, jenis hidangan dan bilik. Booking API memulangkan ketersediaan dan harga langsung serta menerima tempahan. Pilih satu langkah di tengah untuk melihat panggilan yang digunakannya.

Content API

Statik, disimpan di pihak anda
  • Senarai hotelhotels · from=1&to=1000Setiap hotel dalam portfolio anda, dalam halaman sehingga 1,000 hotel bagi setiap permintaan.
  • Kemudahan, jenis hidangan dan bilikfacilities · boards · roomsJadual kod yang menukar kod Booking API kepada perkataan yang difahami oleh tetamu anda.
  • Imejphotos.hotelbeds.com/giata/Laluan imej separa, digabungkan dengan hos foto Hotelbeds dalam saiz yang anda perlukan.
  • Perubahan harianlastUpdateTimeSelepas muatan pertama, satu permintaan sehari dengan lastUpdateTime hanya memulangkan apa yang berubah.

Aliran permintaan

Booking API

Langsung, dipanggil bagi setiap tetamu
  • KetersediaanPOST /hotelsBilik, jenis hidangan, harga dan caj pembatalan untuk kod hotel, tarikh dan bilangan penghuni anda.
  • Semak kadarPOST /checkratesHarga dan syarat terkini bagi kadar bertanda RECHECK, serta pilihan naik taraf.
  • TempahanPOST /bookingsMengesahkan rateKey yang dipilih dengan nama penempah dan tetamu, lalu memulangkan nombor rujukan.
  • PembatalanDELETE /bookings · simulateMenyimulasikan pembatalan untuk menunjukkan caj, atau membatalkan tempahan sebenar.
Skrin contoh. Panggilan seperti yang didokumenkan di developer.hotelbeds.com; aliran ialah cara PHPTRAVELS menggunakannya.

Kebanyakan projek Hotelbeds yang gagal mencampuradukkan kedua-dua pihak ini. Mereka memanggil Content API semasa tetamu membuat carian, yang perlahan dan, seperti yang diberi amaran oleh Hotelbeds, boleh menyebabkan kelayakan anda disekat. Atau mereka mencari secara langsung tanpa kod tersimpan dan tidak dapat memaparkan imej atau kemudahan. PHPTRAVELS mengasingkan kedua-duanya: kandungan disegerakkan di latar belakang, dan hanya panggilan ketersediaan, semak kadar dan tempahan berjalan semasa tetamu menunggu.

Jika anda ingin mengenali pembekal itu sendiri, produknya dan cara membuka akaun, baca profil pembekal Hotelbeds. Halaman ini membincangkan integrasi teknikal.

Jenis kadar

Empat medan kadar yang mengubah proses pembayaran anda

Setiap kadar Hotelbeds membawa beberapa atribut yang menentukan sama ada anda boleh menempahnya serta-merta, harga apa yang boleh dipaparkan dan siapa yang menerima bayaran. Inilah medan yang mesti dibaca oleh enjin anda pada setiap keputusan.

MedanKes pertamaKes keduaApa yang dilakukan PHPTRAVELS

Boleh ditempah atau perlu disemak semula

rateType		BOOKABLE

Kadar adalah terkini. Anda boleh menempahnya tanpa panggilan tambahan.

RECHECK

Anda mesti memanggil semak kadar dahulu untuk mendapatkan harga dan syarat terkini.

Menjalankan semak kadar sebelum langkah pembayaran bagi kadar RECHECK dan menunjukkan sebarang perubahan kepada tetamu.

Bersih atau komisen

net · sellingRate		net

Model bersih: harga adalah harga bersih, jadi anda menambah margin sendiri.

sellingRate

Model komisen: komisen sudah termasuk dalam sellingRate, dan harga itu adalah muktamad.

Menggunakan peraturan markup anda pada kadar bersih dan menjual kadar komisen pada sellingRate.

Harga jualan tetap

hotelMandatory		true

hotelMandatory bernilai true: anda mesti menjual pada sellingRate.

false · null

False atau kosong pada kadar bersih: anda boleh menetapkan margin sendiri.

Mengunci harga yang dipaparkan pada sellingRate apabila hotel memerlukannya, tanpa mengira peraturan markup.

Bila tetamu membayar

paymentType		AT_WEB

Bayaran diambil semasa tempahan dibuat, melalui laman anda.

AT_HOTEL

Tetamu membayar terus kepada hotel.

Melabel kadar sebagai bayar sekarang atau bayar di hotel, dan mengarahkan proses pembayaran mengikutnya.

Model harga yang anda peroleh bergantung pada kontrak Hotelbeds anda. Seperti yang dinyatakan oleh Hotelbeds, pengurus jualan anda akan mengesyorkan model yang sesuai untuk perniagaan anda.

Pemetaan hotel

Padankan hotel Hotelbeds dengan hotel yang sudah anda jual

Jika anda mempunyai kontrak sendiri atau pembekal kedua, hotel yang sama akan tiba dengan kod yang berbeza. Pemetaan menghubungkannya, supaya tetamu melihat satu hotel dengan kadar terbaik, bukan tiga salinan.

Cara pemetaan berfungsi dalam PHPTRAVELS

Selepas setiap penyegerakan kandungan, PHPTRAVELS membandingkan hotel Hotelbeds dengan senarai hotel anda mengikut nama, alamat, bandar dan koordinat. Padanan rapat dipautkan secara automatik. Padanan yang meragukan menunggu pengesahan seseorang, dan hotel tanpa padanan boleh diimport sebagai hartanah baharu atau diabaikan.

Hotel yang dipetakan berkongsi satu halaman, satu galeri dan satu skor ulasan dalam Penginapan, manakala setiap pembekal mengekalkan kadar dan peraturannya sendiri. Pemetaan yang sama digunakan oleh laman awam dan Portal pelancongan B2B anda.

Pemetaan hotel
  • Harbour View HotelLisbon48291397%Dipadankan
  • Old Town SuitesPrague11735492%Dipadankan
  • Palm Court ResortDubai66201874%Semak
  • Casa Azul BoutiqueSeville–0%Tiada padanan
  • Northern Lights LodgeTromsø90522766%Semak
  • Riverside ApartmentsBudapest33076198%Dipadankan

Skrin contoh dengan hotel dan kod rekaan.

Hotelbeds XML atau JSON

Setiap permintaan ditandatangani, dan ujian bermula secara kecil

Banyak pasukan masih mencari Hotelbeds XML, tetapi dokumentasi semasa menunjukkan permintaan JSON. Walau apa pun formatnya, operasinya sama, dan setiap permintaan membawa dua pengepala.

availability-request.sh (contoh)
 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
Dua pengepala
Api-key dengan kunci anda, dan X-Signature: cincangan SHA256 bagi kunci, rahsia dan masa semasa dalam saat.
Hos ujian
Seperti yang dinyatakan oleh Hotelbeds, pelayan ujian sepadan dengan pengeluaran, tetapi tempahan di sana tidak sebenar dan kad tidak dicaj.
50 permintaan sehari
Kunci baharu membuka persekitaran penilaian dengan kuota 50 permintaan sehari. Kuota bertambah selepas pensijilan.
Tiada panggilan kandungan langsung
Hotelbeds memberi amaran bahawa memanggil Content API secara masa nyata boleh menyebabkan kelayakan disekat. PHPTRAVELS tidak pernah berbuat demikian.

Perancang penyegerakan kandungan

Berapa banyak panggilan Content API yang diperlukan oleh senarai hotel anda

Seperti yang dinyatakan oleh Hotelbeds, senarai hotel dihantar dalam halaman sehingga 1,000 hotel, dan selepas muatan pertama, satu permintaan lastUpdateTime sehari hanya memulangkan perubahan. Masukkan angka anda untuk merancang penyegerakan.

Permintaan untuk muatan penuh pertama
20
Permintaan bagi setiap kemas kini harian
3
Hari untuk memuat sekali dengan kuota penilaian
1

Anggaran sahaja, untuk senarai hotel. Jadual kod dan imej menambah beberapa panggilan lagi. Dengan kuota penilaian 50 permintaan sehari, uji dengan satu destinasi dahulu.

Senarai semak sebelum langsung

Apa yang perlu disediakan sebelum beralih ke langsung

Hotelbeds membawa anda dari penilaian ke pensijilan dan kemudian ke kunci langsung melalui papan pemukanya. Inilah perkara yang perlu diliputi dahulu oleh integrasi Hotelbeds API, dan cara PHPTRAVELS meliputinya.

  • Kunci penilaian ditambah dalam admin, hos ujian dipilih
  • Content API disegerakkan ke pangkalan data anda, dengan kemas kini harian dijadualkan
  • Hotel dipetakan ke senarai anda, padanan meragukan telah disemak
  • Kadar RECHECK melalui semak kadar sebelum pembayaran
  • sellingRate dipatuhi apabila hotelMandatory bernilai true
  • Catatan kadar dan caj pembatalan dipaparkan sebelum tetamu membayar
  • Baucar memaparkan rujukan Hotelbeds dan catatan kadar
  • Pembatalan disimulasikan dahulu, kemudian disahkan, dengan caj direkodkan

Langkah pensijilan dan akses langsung ditetapkan oleh Hotelbeds mengikut kontrak dan pasaran anda.

Kos

Satu lesen untuk enjin, kontrak anda sendiri dengan Hotelbeds

PHPTRAVELS ialah lesen sekali bayar dengan kod sumber. Hotelbeds ialah perjanjian berasingan antara anda dan Hotelbeds, jadi kadar bersih dan kunci kekal milik anda.

Permulaan
Lesen sekali bayar
lesen sekali bayar
Agensi
Lesen sekali bayar
lesen sekali bayar
Perusahaan
Lesen sekali bayar
lesen sekali bayar

Hotelbeds ialah salah satu daripada beberapa sumber hotel yang boleh anda jalankan bersebelahan. Lihat cara ia bergabung dengan RateHawk dalam gambaran keseluruhan API pelancongan, atau bandingkan pembekal dalam senarai pembekal XML.

Lihat hargaCuba demo hotel

Soalan lazim

Soalan tentang integrasi Hotelbeds API

Perkara yang ditanya oleh pembangun dan syarikat pelancongan sebelum menyambung Hotelbeds.

Hubungi jualan

Dua bahagian. Penyegerakan latar belakang dengan Content API yang menyimpan hotel, imej, kemudahan, jenis hidangan dan bilik dalam pangkalan data anda, serta aliran langsung dengan Booking API untuk ketersediaan, semak kadar, tempahan dan pembatalan. PHPTRAVELS menjalankan kedua-duanya dalam modul hotel.

Orang masih memanggilnya Hotelbeds XML, tetapi dokumentasi Hotelbeds semasa menunjukkan permintaan dan respons JSON. Operasinya sama, dan PHPTRAVELS mengendalikan format untuk anda.

Kadar BOOKABLE sudah terkini dan boleh ditempah serta-merta. Kadar RECHECK memerlukan panggilan semak kadar dahulu, yang memulangkan harga dan syarat semasa. PHPTRAVELS membuat panggilan itu sebelum langkah pembayaran.

Ia perlahan, dan Hotelbeds memberi amaran bahawa menggunakan Content API secara masa nyata boleh menyebabkan kelayakan disekat. Kandungan patut dimuat turun mengikut halaman, disimpan dan dikemas kini sekali sehari dengan lastUpdateTime, iaitu cara PHPTRAVELS berfungsi.

Ya. Anda mendaftar dengan Hotelbeds, menandatangani kontrak dan menerima API key serta rahsia anda sendiri. Kunci baharu berfungsi dalam persekitaran penilaian dengan 50 permintaan sehari sehingga anda melengkapkan pensijilan.

Boleh. Pemetaan hotel menghubungkan hartanah yang sama merentas sumber, supaya tetamu melihat satu hotel dengan kadar terbaik yang tersedia, manakala setiap sumber mengekalkan markup dan peraturannya sendiri.

Pelan PHPTRAVELS bermula dari sebagai lesen sekali bayar dengan kod sumber. Kontrak Hotelbeds anda adalah berasingan dan dipersetujui terus dengan Hotelbeds. Lihat halaman harga atau minta sebut harga daripada pasukan jualan.

Terokai lagi

Lagi tentang platform