Demo langsung

API penginapan

API Penginapan untuk hotel, apartmen dan rumah percutian

API penginapan membawa setiap jenis penginapan ke laman tempahan anda: bilik hotel, apartmen servis, rumah percutian, hostel dan rumah tumpangan. Halaman ini menerangkan data di sebalik sesuatu penginapan, peraturan yang membezakan sewaan daripada hotel, dan cara PHPTRAVELS menjual hartanah anda sendiri serta stok pembekal dalam satu carian.

  • Hartanah, unit, kadar, kalendar
  • Penginapan minimum dan yuran
  • Tetingkap pembatalan
  • Stok sendiri dan bekalan API

Model data

Empat lapisan dalam setiap penginapan

Sama ada hotel 300 bilik atau sebuah rumah tepi pantai, API penginapan menerangkannya dalam empat lapisan bersarang yang sama. Setiap lapisan menjawab soalan berbeza yang ditanya tetamu sebelum menempah.

01Hartanah

Tempat itu sendiri: nama, jenis, alamat dan kedudukan pada peta, foto, kemudahan, penarafan bintang atau kualiti, peraturan rumah dan waktu daftar masuk.

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

02Bilik atau unit

Apa yang sebenarnya ditempah: satu jenis bilik, satu apartmen penuh atau satu katil di dorm, lengkap dengan saiz, katil dan penghunian maksimum.

unit_id · beds · size_m2 · max_adults · max_children

03Pelan kadar

Cara unit itu dijual: pakej makan, dasar pembatalan, syarat bayaran dan siapa yang boleh menempahnya, contohnya orang awam atau ejen sahaja.

rate_plan_id · board · cancel_policy · payment · channel

04Ketersediaan

Satu baris setiap malam: harga, baki unit, penginapan minimum dan sama ada ketibaan atau pelepasan dibenarkan pada hari itu.

date · price · units_left · min_stay · closed_to_arrival

Sebuah bangunan, bilik, tag kadar dan kalendar dilukis sebagai lapisan bertindan bagi satu penyenaraian penginapan

PHPTRAVELS menamakan modul penginapannya Stays kerana model yang sama merangkumi jauh lebih banyak daripada hotel. Sesebuah hartanah mengandungi unit, sesuatu unit dijual melalui satu atau lebih pelan kadar, dan setiap pelan kadar mempunyai kalendar malam demi malam bagi harga dan ketersediaan. Jika empat lapisan ini betul, katil hostel, suite hotel dan vila tiga bilik semuanya muat dalam carian dan pembayaran yang sama.

Pembekal menamakan lapisan ini secara berbeza, dan ada yang menggabungkan dua lapisan, tetapi strukturnya sentiasa ada. Penginapan memetakan setiap sumber kepadanya, jadi tetamu melihat satu halaman yang konsisten.

Malam demi malam

Kalendar ketersediaan menentukan penginapan terjual atau tidak

Setiap API penginapan berakhir pada kalendar. Carian hanya memulangkan hartanah apabila setiap malam bagi penginapan yang diminta masih kosong, ada harga dan dibenarkan oleh peraturan penginapan.

Apartmen dua bilik · Kadar standardNovember 2026 · Harga seunit semalam
  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
  • Kosong, berharga semalam
  • Sudah ditempah
  • Ditutup oleh pemilik
  • Penginapan minimum dari ketibaan ini
  • Tertutup untuk ketibaan

Data ilustrasi, dipermudah

  • Harga adalah semalamJumlah penginapan ialah hasil tambah setiap malam, jadi Jumaat dan Sabtu pada kadar hujung minggu lebih mahal daripada dua hari bekerja. Harga harian dan bermusim terletak pada kalendar, bukan pada hartanah.
  • Peraturan penginapan minimumMinimum tiga malam bagi ketibaan hari Jumaat menyembunyikan unit daripada carian dua malam. Sewaan menggunakan peraturan ini jauh lebih kerap daripada hotel, selalunya lebih ketat pada hujung minggu dan musim puncak.
  • Tertutup untuk ketibaan atau pelepasanSatu malam boleh ditempah sebagai sebahagian penginapan yang lebih panjang tetapi bukan sebagai malam pertama atau terakhir. Hari pertukaran tetamu bagi rumah percutian berfungsi begini.
  • Malam tertutup dan stop-sellPemilik menyekat tarikh untuk kegunaan sendiri atau penyelenggaraan, dan stop-sell serta-merta menarik unit daripada jualan. Mana-mana malam tertutup dalam tarikh yang diminta akan mengeluarkan unit daripada hasil.

Bukan semua penginapan ialah hotel

Hotel berbanding apartmen dan rumah percutian

Model datanya sama, tetapi setiap jenis penginapan mengisinya dengan cara berbeza. Inilah perbezaan yang mesti dikendalikan oleh aliran tempahan anda apabila anda menjual lebih daripada bilik hotel.

Hotel

Termasuk hostel dan rumah tumpangan

Apa yang ditempah
Satu jenis bilik dengan banyak bilik serupa, atau satu katil dalam dorm bersama.
Harga
Kadar semalam bagi setiap bilik dan pakej makan; dewasa atau kanak-kanak tambahan boleh mengubahnya.
Peraturan penginapan
Penginapan minimum pada tarikh puncak sahaja; kebanyakan malam boleh ditempah seorang diri.
Yuran dan deposit
Cukai bandar atau pelancong, kadangkala yuran resort yang dibayar di hartanah.
Ketibaan
Kaunter depan 24 jam atau berkakitangan; waktu daftar masuk pada baucar sudah memadai.
Sumber lazim
Bedbank dan pemborong, kontrak terus, channel manager.

Apartmen servis

Hotel apartmen dan apartmen bandar

Apa yang ditempah
Satu jenis unit, selalunya dengan dapur dan bilik tidur berasingan.
Harga
Kadar semalam bagi setiap unit, dengan harga mingguan atau bulanan untuk penginapan panjang.
Peraturan penginapan
Penginapan minimum adalah lazim, dan penginapan panjang merupakan sebahagian besar permintaan.
Yuran dan deposit
Yuran pembersihan bagi setiap penginapan dan deposit boleh dikembalikan adalah lazim.
Ketibaan
Waktu penerimaan tetamu berbeza; ketibaan lewat memerlukan peti kunci atau kod.
Sumber lazim
Channel manager, kontrak terus dan beberapa pemborong.

Rumah percutian

Rumah, vila dan kabin percutian

Apa yang ditempah
Satu rumah tertentu. Lazimnya hanya ada satu.
Harga
Kadar semalam untuk seluruh rumah, ditambah caj bagi setiap tetamu tambahan melebihi bilangan asas.
Peraturan penginapan
Penginapan minimum, hari pertukaran tetap dan tarikh tertutup untuk ketibaan ialah kebiasaan.
Yuran dan deposit
Yuran pembersihan, deposit kerosakan boleh dikembalikan dan cukai tempatan, masing-masing dipaparkan sebelum pembayaran.
Ketibaan
Arahan daftar masuk, alamat dan hubungan dihantar sebelum ketibaan, tidak pernah di halaman awam.
Sumber lazim
Pemilik dan pengurus hartanah, secara terus atau melalui channel manager.

Menjual rumah daripada ramai tuan rumah dan bukan kontrak anda sendiri? Itu pasar atas talian, dibincangkan di halaman Portal BnB.

Tetingkap dasar pembatalan

Satu tempahan, tiga tetingkap pembatalan

Dasar pembatalan ialah garis masa yang dikira ke belakang dari tarikh ketibaan. Setiap tetingkap menyatakan apa yang diperoleh semula tetamu jika membatalkan dalam tempoh itu.

TempahanDaftar masuk
  1. 01 · Sehingga 14 hari sebelum ketibaanPembatalan percumaTetamu membatalkan dan dibayar balik sepenuhnya. Inilah tarikh akhir yang dicari pelancong dahulu, jadi paparkan sebagai tarikh, bukan peraturan.
  2. 02 · 14 hingga 3 hari sebelumPenalti separaPenalti dikenakan, selalunya malam pertama atau peratusan penginapan. Sewaan mungkin menahan deposit dalam tetingkap ini.
  3. 03 · 3 hari terakhir dan tidak hadirTidak boleh dikembalikanSeluruh jumlah ditahan. Kadar yang dijual sebagai tidak boleh dikembalikan bermula dalam tetingkap ini sejak saat tempahan.
Contoh tetingkap; setiap pelan kadar mempunyai tetingkapnya sendiri.
  • Bagi setiap pelan kadar, bukan setiap hartanahApartmen yang sama boleh mempunyai kadar fleksibel dan kadar tidak boleh dikembalikan yang lebih murah, jadi dasar itu tergolong dalam lapisan pelan kadar.
  • Tarikh mengikut zon waktu hartanah"14 hari sebelum" dikira dari tarikh ketibaan di lokasi hartanah. Tukarkannya kepada tarikh dan waktu yang jelas pada halaman dan baucar.
  • Dasar pembekal diutamakanDengan stok API, anda tidak boleh menawarkan syarat yang lebih longgar daripada pembekal. Dengan kontrak sendiri, anda menetapkan tetingkap itu sendiri.

Stok sendiri dan stok API

Hartanah berkontrak anda dan API pembekal dalam satu carian

Kebanyakan penjual penginapan melakukan kedua-duanya: memuatkan tempat yang mereka kontrak sendiri dan menambah API pembekal untuk selebihnya. Pelancong tidak sepatutnya sedar dari mana asal sesuatu penginapan.

Hartanah anda sendiri

  • Muatkan hartanah, unit dan pelan kadar sendiri dalam admin
  • Beri pemilik dan hotel log masuk extranet untuk mengurus kalendar mereka
  • Tetapkan harga, penginapan minimum, tarikh tertutup dan tetingkap pembatalan
  • Allotment dengan hari pelepasan dan stop-sell
  • Atau terima kadar dan ketersediaan daripada channel manager

Stok pembekal melalui API

  • Katalog besar di destinasi yang mustahil anda kontrak sendiri
  • Harga dan ketersediaan langsung semasa carian
  • Pakej makan, dasar dan yuran pembekal pada setiap kadar
  • Diaktifkan dengan kontrak dan kelayakan pembekal anda sendiri
  • Tempahan dan pembatalan dihantar terus kepada pembekal

Apa yang diperoleh tetamu

  • Satu senarai hasil dengan satu halaman hartanah bagi setiap tempat
  • Bilik yang sama daripada beberapa sumber dipaparkan sekali, pada harga anda
  • Markup anda mengikut pembekal, destinasi atau saluran, serta kadar ejen B2B
  • Satu format baucar, sama ada sumber mana yang mengesahkan

Cara menyambung channel manager dibincangkan di Integrasi channel manager. Untuk bilik yang anda pegang melalui kontrak, lihat Sistem inventori tempahan.

Sedia dalam PHPTRAVELS

Pembekal penginapan yang sudah disambungkan

Pembekal penginapan ini sudah disambungkan kepada modul Stays. Anda menandatangani kontrak dengan pembekal, memasukkan kelayakan anda sendiri dalam admin, menguji dalam sandbox mereka dan terus beroperasi. Senarai ini datang secara langsung daripada direktori integrasi kami.

Perlukan pembekal yang tiada dalam senarai, seperti rangkaian sewaan serantau? Mana-mana API penginapan yang mempunyai dokumentasi boleh ditambah, lihat Integrasi API tersuai. Untuk jenis pembekal hotel dan pemetaan kandungan, baca halaman API Hotel, serta dua panduan bedbank terbesar: Integrasi API RateHawk dan Integrasi Hotelbeds API.

Tempah penginapan seperti yang akan dilakukan tetamu anda

Cari, banding kadar dan tempah dalam demo langsung, kemudian beritahu kami hartanah dan pembekal yang anda rancang untuk dijual.

Cuba demo langsungTanya tentang pembekal anda

Membina aplikasi sendiri atau suapan rakan kongsi? REST API PHPTRAVELS menyediakan setiap sumber penginapan yang disambungkan dalam satu format, dengan webhook untuk acara tempahan. Ia disertakan dengan pelan Enterprise, lihat Harga dan dokumentasi pembangun. Gambaran lebih luas ada di API pelancongan.

Soalan Lazim

API Penginapan: soalan daripada pembangun dan agensi

Hubungi jualan

API penginapan ialah satu set perkhidmatan web yang membolehkan laman tempahan mencari penginapan, membaca harga dan ketersediaan bagi tarikh dan tetamu tertentu, serta mencipta, membaca dan membatalkan tempahan. Ia merangkumi hotel dan setiap jenis penginapan lain: apartmen, rumah percutian, hostel dan rumah tumpangan.

Panggilan terasnya sama. API penginapan juga mesti mengendalikan keperluan penginapan bukan hotel: tempahan seluruh unit, penginapan minimum dan hari pertukaran tetamu, caj tetamu tambahan, yuran pembersihan, deposit boleh dikembalikan dan arahan daftar masuk yang dihantar sebelum ketibaan.

Boleh. Dalam PHPTRAVELS, modul Stays menggunakan satu model hartanah, unit, pelan kadar dan ketersediaan bagi setiap jenis penginapan, jadi hotel, apartmen dan rumah percutian muncul dalam carian yang sama dengan peraturan masing-masing.

Setiap malam dalam kalendar boleh mempunyai tempoh penginapan minimum, biasanya dikaitkan dengan tarikh ketibaan. Jika tetamu mencari kurang malam daripada minimum, unit tidak dipulangkan. Bendera tertutup untuk ketibaan dan pelepasan berfungsi dengan cara yang sama bagi hari pertukaran tetamu.

Boleh. Anda boleh menambah hartanah, unit, pelan kadar dan kalendar sendiri, memberi pemilik log masuk extranet, atau menerima kadar daripada channel manager, dan menjualnya bersebelahan stok pembekal dalam satu senarai hasil.

Daripada pelan kadar. Stok pembekal membawa dasar pembekal, dan hartanah anda sendiri menggunakan tetingkap yang anda tetapkan. Tarikh akhirnya dipaparkan kepada tetamu sebelum pembayaran dan dicetak pada baucar.

Tidak. Anda menandatangani kontrak dengan setiap pembekal penginapan dan memasukkan kelayakan anda sendiri dalam admin. PHPTRAVELS menyediakan platform tempahan, modul Stays dan penyambung yang sedia ada.

Boleh. Pada pelan Enterprise, REST API PHPTRAVELS mendedahkan carian dan tempahan merentas setiap sumber yang disambungkan dalam satu format, dengan webhook untuk acara tempahan dan kod sumber penuh untuk dikembangkan.

Lesen PHPTRAVELS, domain anda sendiri dan sekurang-kurangnya satu sumber stok: hartanah yang anda kontrak sendiri, channel manager, atau kontrak pembekal dengan pemborong penginapan. Demo langsung menunjukkan aliran penuh terlebih dahulu.

Terokai lagi

Lagi tentang platform