API Hotel
Cari 1.5M+ hartanah mengikut kod bandar (gaya IATA, cth. DXB) atau kod hotel yang anda simpan daripada katalog kami, baca kadar peringkat bilik berserta jenis makanan dan polisi pembatalan, sahkan dan tempah, serta batalkan mengikut polisi.
Carian
POST /v1/hotels/search with a destination and check-in/out dates and one to eight rooms (adults and child ages per room). The destination is a cityCode (IATA-style, e.g. "DXB" — GET /v1/content/cities lists them), a list of hotelCodes from the catalogue you store on your side (GET /v1/content/hotels per city), or a geo circle. Name matching is yours to do against your stored list; availability is always asked by code.
Dengan wait=true anda mendapat set hasil penuh; dengan wait=false, searchId untuk ditinjau dengan GET /v1/hotels/search/{searchId} — hantar tarikh dan bilangan bilik yang sama supaya kunci kadar kekal boleh ditempah. Setiap hotel membawa kandungannya (nama, bintang, alamat, geo, imej utama, kemudahan) dan kadar termurah bagi setiap bilik dengan rateKey yang legap, jumlah dan harga semalam, jenis makanan, status boleh dibayar balik dan tarikh akhir pembatalan.
Bilik dan kadar
GET /v1/hotels/{hotelCode}/rooms?rateKey=… menyenaraikan setiap jenis bilik dan kadar sesebuah hartanah untuk penginapan yang dicari: jenis katil, penghunian, jenis makanan, polisi, cukai dan yuran yang diperincikan, serta sama ada kadar itu boleh dibayar balik.
Semakan kadar
POST /v1/hotels/rates/{rateKey}/check mengesahkan bahawa kadar masih boleh ditempah dan mengembalikan harga serta polisi muktamad. Lakukan ini sejurus sebelum menempah: 409 price_changed atau rate_expired di sini jauh lebih murah daripada tempahan yang gagal.
Tempah
POST /v1/hotels/bookings dengan rateKey, pemegang tempahan, tetamu bagi setiap bilik dan maklumat hubungan, serta Idempotency-Key. Respons ialah tempahan berserta rujukannya, pengesahan pembekal dan data baucar. GET /v1/hotels/bookings/{bookingId} mengembalikannya semula pada bila-bila masa.
Batal
GET /v1/hotels/bookings/{bookingId}/cancellation-quote mengembalikan penalti mengikut polisi pada saat ini; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key diperlukan) melaksanakannya.