Request API Hotel

---

Pengaturan request RESTful API untuk hotel.

• Alur Booking
• Skema API
• Autentikasi
• Parameter Wajib
• Test Case

Alur Booking

Urutan pemanggilan endpoint yang disarankan:

1. Cari Destinasi / Negara + Kota untuk mendapatkan city_id atau property_id
2. Inisiasi untuk memulai sesi pencarian dan mendapatkan session
3. Filter (opsional) untuk mempersempit hasil pencarian
4. Detail Properti untuk melihat kamar dan group_id
5. Recheck untuk memastikan ketersediaan dan tarif
6. Booking untuk melakukan pemesanan
7. Detail Booking atau Webhook / Callback untuk cek status

{info} Sesi hasil inisiasi kedaluwarsa dalam 20 menit. Setelah kedaluwarsa, lakukan inisiasi ulang.

Skema API

API hotel mendukung request JSON. Endpoint GET mengirim parameter melalui query string. Endpoint POST mengirim parameter melalui body JSON.

Header Key	Value
Content-Type	application/json

{info} Berbeda dengan API prabayar/pascabayar, beberapa endpoint hotel menggunakan method GET (Negara, Kota, dan Detail Booking).

Autentikasi

API hotel menggunakan hash MD5 untuk autentikasi. Sertakan sign pada setiap request.

Parameter	Value
sign	md5(username + api_key + additional)

Komponen	Deskripsi
username	Username API yang didapatkan dari menu atur koneksi API
api_key	Terdapat 2 API key: development dan production. Gunakan API key yang sesuai dengan environment yang Anda gunakan
additional	Value additional berbeda di tiap endpoint. Lihat dokumentasi masing-masing endpoint

Parameter Wajib

Setiap request API hotel memiliki parameter wajib berikut:

Parameter	Tipe	Wajib	Deskripsi
username	String	Ya	Username API Anda
sign	String	Ya	Signature MD5 untuk autentikasi (lihat Autentikasi)
code	String	Ya	Kode produk hotel Anda

Parameter tambahan bergantung pada endpoint yang digunakan.

Test Case

{info} Semua response pada test case merupakan data simulasi.

Ada dua cara untuk menggunakan test case:

1. Tambahkan parameter is_testing pada request

Parameter	Tipe	Deskripsi
is_testing	Boolean	Isi dengan true untuk menggunakan response test case

2. Ubah Mode menjadi Development pada menu atur koneksi API

{info} Jika Mode koneksi API sudah Development, seluruh request akan menggunakan test case meskipun is_testing tidak dikirim.

Gunakan api_key development untuk melakukan request test case. Detail value test case ada di dokumentasi masing-masing endpoint.