Lewati ke konten
Demo langsung

API Hotel

Cari 1.5M+ properti berdasarkan kode kota (gaya IATA, mis. DXB) atau kode hotel yang Anda simpan dari katalog kami, baca tarif per kamar beserta jenis makanan dan kebijakan pembatalan, validasi dan pesan, lalu batalkan sesuai kebijakan.

  1. Pencarian
  2. Kamar dan tarif
  3. Cek tarif
  4. Pesan
  5. Batalkan

Pencarian

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 seluruh hasil; dengan wait=false sebuah searchId untuk di-polling dengan GET /v1/hotels/search/{searchId} — kirim tanggal dan jumlah kamar yang sama agar kunci tarif tetap dapat dipesan. Setiap hotel membawa kontennya (nama, bintang, alamat, geo, gambar utama, fasilitas) dan tarif termurah per kamar dengan rateKey yang opak, harga total dan per malam, jenis makanan, status dapat dikembalikan, dan batas waktu pembatalan.

Kamar dan tarif

GET /v1/hotels/{hotelCode}/rooms?rateKey=… mencantumkan setiap tipe kamar dan tarif dari satu properti untuk masa inap yang dicari: tipe tempat tidur, kapasitas, jenis makanan, kebijakan, pajak dan biaya yang dirinci, serta apakah tarifnya dapat dikembalikan.

Cek tarif

POST /v1/hotels/rates/{rateKey}/check memastikan tarif masih dapat dipesan dan mengembalikan harga serta kebijakan final. Lakukan ini tepat sebelum memesan: 409 price_changed atau rate_expired di sini jauh lebih murah daripada pemesanan yang gagal.

Pesan

POST /v1/hotels/bookings dengan rateKey, pemegang pemesanan, tamu per kamar, dan kontak, ditambah Idempotency-Key. Responsnya adalah pemesanan beserta referensinya, konfirmasi pemasok, dan data voucher. GET /v1/hotels/bookings/{bookingId} mengembalikannya lagi kapan saja.

Batalkan

GET /v1/hotels/bookings/{bookingId}/cancellation-quote mengembalikan penalti menurut kebijakan pada saat itu; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key wajib) mengeksekusinya.