Inisiasi

Inisiasi sesi pencarian properti.

{info} Sesi akan kedaluwarsa dalam 20 menit. Setelah kedaluwarsa, Anda harus melakukan inisiasi ulang untuk mendapatkan sesi baru dengan tarif kamar yang baru.

Endpoint

Attribute Value
Method POST 

https://8stars.api.digiswitch.id/v1/user/api/hotel/search

Request

Sign additional value: hotel.search

{info} Gunakan Filter untuk paginasi lanjutan jika sesi masih berlaku.

Contoh

{
  "username": "YOUR_USERNAME",
  "sign": "96e1028f6beaa817ee3670a39c01c69d",
  "code": "skuhotel",
  "city_id": "V1A7Q",
  "check_in": "2026-02-12",
  "check_out": "2026-02-14",
  "stars": [3, 4, 5],
  "pax_count": {
    "total_room": 1,
    "total_adult": 2,
    "total_child": 0,
    "child_age": []
  }
}
Parameter Deskripsi Tipe Data Wajib
username Username yang didapatkan dari menu atur koneksi API String Ya
sign Signature dengan formula
md5(username + apiKey + "hotel.search")		 String Ya
code Kode produk hotel String Ya
city_id ID kota String Ya
property_id ID properti, untuk mencari 1 properti spesifik String Tidak
check_in Tanggal check in, format YYYY-MM-DD String Ya
check_out Tanggal check out, format YYYY-MM-DD String Ya
lang Bahasa response. Default: id String Tidak
stars Kategori bintang properti yang ingin dicari Array of Int Tidak
pax_count Objek Jumlah Tamu Object Ya
pax_count.total_room Jumlah kamar Int Ya
pax_count.total_adult Jumlah orang dewasa (1 - 4) Int Ya
pax_count.total_child Jumlah anak-anak (0 - 2) Int Tidak
pax_count.child_age Umur anak-anak, hingga 18 tahun. Sesuaikan dengan jumlah total_child Array of Int Tidak
page Halaman paginasi. Default: 1 Int Tidak

Response

data berisi array ringkasan Properti. Gunakan endpoint Detail Properti untuk mendapatkan detail kamar.

Contoh

{
  "message": "Sukses",
  "rc": "00",
  "data": [
    {
      "id": "jkt1",
      "name": "Hotel Indonesia Kempinski Jakarta",
      "star": 5,
      "type": "hotel",
      "main_photo": "https://ik.imagekit.io/vcrk/dev/hotel",
      "address": {
        "area": "City Center"
      },
      "room_summary": {
        "min_total_price": 3316126,
        "total_available_room": 3
      }
    },
    {
      "id": "jkt2",
      "name": "Midtown Residence Simatupang Jakarta",
      "star": 4,
      "type": "aparthotel",
      "main_photo": "https://ik.imagekit.io/vcrk/dev/hotel",
      "address": {
        "area": "Cilandak - South Jakarta"
      },
      "room_summary": {
        "min_total_price": 927219,
        "total_available_room": 2
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 20,
    "total": 2,
    "session": "2dfa0748-3b56-4255-aab2-6f62b8884353"
  }
}
Parameter Deskripsi Tipe Data
id ID properti String
name Nama properti String
star Kategori bintang properti Int
type Tipe properti String
main_photo Foto properti String
address Alamat properti Object
room_summary Ringkasan kamar Object
room_summary.min_total_price Harga kamar termurah Int
room_summary.total_available_room Total kamar yang tersedia Int

Meta Data

Parameter Deskripsi Tipe Data Catatan
current_page Halaman saat ini Int
last_page Halaman terakhir Int
per_page Data yang tampil tiap halaman Int
total Jumlah data Int
session Sesi pencarian properti String Gunakan value ini pada endpoint yang membutuhkan sesi

Test Case

city_id Hasil
V1A7Q Properti di Jakarta
xlKY1 Properti di Bali

Contoh

{
  "username": "YOUR_USERNAME",
  "sign": "96e1028f6beaa817ee3670a39c01c69d",
  "code": "skuhotel",
  "city_id": "V1A7Q",
  "check_in": "2026-02-12",
  "check_out": "2026-02-14",
  "stars": [3, 4, 5],
  "pax_count": {
    "total_room": 1,
    "total_adult": 2,
    "total_child": 2,
    "child_age": [2, 5]
  },
  "is_testing": true
}