API dan integrasi

Little Hotelier punya API? Jawaban 2026 dan cara mengambil data Anda

Tidak ada API key untuk reservasi atau tamu Anda. Apa yang resmi dari SiteMinder, dan cara membaca data Little Hotelier lewat REST dalam hitungan menit.

8 menit baca Hotelier Tools
Halaman REST API reference di Hotelier Tools dengan base URL, unduhan openapi.json, kotak Quick authorize (kolom Bearer token, Authorize Swagger, Use my session), dan template kode dalam cURL, JavaScript, Python, dan PowerShell
Di halaman ini
  1. Apakah Little Hotelier punya API publik?
  2. Cara mengambil data Little Hotelier Anda secara terprogram
  3. Cara membuat API key dan melakukan panggilan pertama
  4. Endpoint apa saja yang bisa dipakai?
  5. Batas, error, dan hal yang tidak tersedia
  6. Apa yang bisa Anda bangun dengannya?
  7. Langkah berikutnya

Tidak ada yang bisa Anda pakai untuk reservasi Anda sendiri. Per Oktober 2026, pusat bantuan Little Hotelier tidak mendokumentasikan API key yang bisa dipakai properti untuk reservasi, tamu, atau invoice-nya: API SiteMinder diperuntukkan bagi mitra teknologi bersertifikasi, dan satu-satunya key yang bisa Anda buat sendiri, Direct Booking API, mencakup tarif, ketersediaan, dan detail properti untuk situs pemesanan. Untuk membaca data Anda sendiri dari skrip, spreadsheet, atau asisten AI, Anda bisa memakai REST API independen seperti Hotelier Tools, yang terhubung dengan login Little Hotelier Anda sendiri.

Di bawah ini: apa persisnya yang ditawarkan SiteMinder, lalu setup lima menit dengan contoh curl sungguhan.

Apakah Little Hotelier punya API publik?

Ada empat cara resmi untuk memasukkan atau mengeluarkan data dari Little Hotelier. Tidak satu pun memberi Anda API key untuk daftar reservasi Anda.

Opsi resmiSiapa yang bisa memakaiCakupan
SiteMinder Exchange (SMX)Aplikasi mitra bersertifikasiReservasi dari Little Hotelier. Bukan ketersediaan atau tarif
Direct Booking APIProperti yang memakai Direct BookingHarga dan ketersediaan real-time, properti, tipe kamar, rate plan
Ekspor CSVPengguna mana pun, secara manualReservasi, pendapatan, invoice, akuntansi
Aplikasi App StoreProperti mana pun, lewat vendor aplikasinyaApa pun yang disinkronkan aplikasi itu

SiteMinder Exchange (SMX): untuk perusahaan software

Panduan pengembang SiteMinder mencantumkan lima API: pmsXchange, SiteConnect, Channels Plus, SMX, dan Direct Booking. Yang penting untuk Little Hotelier adalah SMX, API di balik aplikasi seperti check-in online dan pesan tamu.

Dalam daftar penerbit SMX milik SiteMinder, Little Hotelier mengirim reservasi tetapi bukan ketersediaan dan tarif. Panduan cepat SMX menyatakan hal yang sama: "you are not able to obtain ARI data" dari Little Hotelier.

Aksesnya untuk mitra. FAQ SiteMinder menyebut Anda harus lebih dulu menandatangani perjanjian kemitraan melalui formulir pendaftaran integrasi, lalu membangun, mensertifikasi, dan go live, yang menurut mereka diselesaikan "most" mitra dalam 60 hari. Jalur itu cocok untuk perusahaan software. Satu hotel tidak bisa mendapatkan SMX key untuk dirinya sendiri.

Direct Booking API: satu-satunya key yang bisa Anda buat

Jika akun Anda berada di platform Little Hotelier yang lebih baru (pendaftaran sejak Mei 2025, atau akun yang sudah di-upgrade), pusat bantuan mendokumentasikan Direct Booking API:

  1. Buka Direct booking → Configuration → API integration.
  2. Klik Generate key.
  3. Berikan key tersebut dan panduan pengembang SiteMinder kepada web developer Anda.

API ini mengembalikan harga dan ketersediaan real-time, detail properti, tipe kamar, dan rate plan, sehingga developer dapat membuat halaman atau aplikasi pemesanan khusus. Tersedia bersama Direct Booking tanpa biaya tambahan. API ini tidak mengembalikan reservasi, tamu, pembayaran, atau invoice, dan dukungan Little Hotelier tidak membantu membangun atau memperbaiki apa yang Anda buat dengannya.

Ekspor CSV dan App Store

Selebihnya dilakukan manual atau lewat vendor. Halaman Reservations dan sebagian besar laporan dapat diekspor ke CSV (langkah demi langkah di cara mengekspor reservasi ke Excel). Aplikasi di Little Hotelier App Store terhubung ketika Anda menghubungi penyedia aplikasinya; Anda sendiri tidak mendapatkan datanya. Lihat integrasi Little Hotelier terbaik untuk yang tersedia.

Cara mengambil data Little Hotelier Anda secara terprogram

Hotelier Tools adalah dashboard independen untuk properti Little Hotelier. Di dalamnya ada REST API (status: beta) dan MCP server untuk asisten AI.

Cara kerjanya, dengan bahasa sederhana:

  • Anda menghubungkan login Little Hotelier Anda sendiri satu kali, di Credentials (/credentials). Login disimpan terenkripsi (AES-256-GCM).
  • Hotelier Tools lalu memakai endpoint web yang sama dengan yang dipakai aplikasi web Little Hotelier. Ia hanya bisa membaca dan melakukan apa yang bisa dilakukan login tersebut, tidak lebih.
  • Skrip Anda memanggil Hotelier Tools dengan API key, dan Hotelier Tools berkomunikasi dengan Little Hotelier.

Cara membuat API key dan melakukan panggilan pertama

Anda memerlukan akun Hotelier Tools (daftar di dashboard.hotelier.tools/register) dengan Little Hotelier yang sudah terhubung di Credentials. Pemilik properti memiliki akses API secara default.

  1. Buka Developer → API & MCP → API Keys (/developer/api-keys).
  2. Di bawah "Generate a new key", ketik nama yang akan mudah Anda kenali nanti, misalnya sheets-export, lalu tekan Generate key.
  3. Salin key tersebut segera. Halaman memperingatkan: "Copy this key now — it will not be shown again." Key diawali dengan htk_.
Halaman API keys tepat setelah membuat key: kotak hijau Key generated dengan key sekali-tampil yang disamarkan dan tombol salin, key Blog integration yang baru di bawah Active keys dengan tombol Revoke, dan toast API key created
Salin key dari kotak hijau segera: key hanya ditampilkan sekali. Beri nama setiap key sesuai pemakainya, supaya Anda tahu mana yang perlu dicabut nanti.
  1. Pastikan API menjawab. Panggilan ini publik dan tidak memerlukan key:
bash
curl https://dashboard.hotelier.tools/api/v1/health
  1. Sekarang panggilan dengan key Anda. Panggilan ini mengembalikan ID properti Little Hotelier Anda dan login yang dipakainya:
bash
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
  https://dashboard.hotelier.tools/api/v1/property

Di Windows, ketik curl.exe sebagai ganti curl di PowerShell, atau gunakan perintah bawaan PowerShell:

powershell
$headers = @{ Authorization = "Bearer htk_YOUR_API_KEY" }
Invoke-RestMethod -Headers $headers -Uri "https://dashboard.hotelier.tools/api/v1/property"

Apa yang bisa dilakukan sebuah key: tidak ada scope. Key bertindak pada satu properti tempat ia dibuat, sebagai orang yang membuatnya, dengan izin orang itu saat ini. Setiap orang dapat memiliki hingga 10 key, dan Anda dapat mencabut salah satunya di halaman yang sama.

Lebih suka klik daripada mengetik? Pakai explorer

Buka REST API & Swagger (/developer/rest-api). Di Quick authorize, tempel key Anda ke "Bearer token (API key or session JWT)" lalu tekan Authorize Swagger, atau tekan Use my session untuk melewati key. Setelah itu coba endpoint apa pun di "Interactive API explorer". Halaman ini juga punya Download spec dan "Code templates" dalam cURL, JavaScript, Python, dan PowerShell.

Interactive API explorer (Swagger) setelah Try it out dan Execute pada GET /property: URL permintaan https://demo.hotelier.tools/api/v1/property dan isi respons 200 dengan propertyId 90210
Otorisasi sekali, lalu jalankan endpoint apa pun dari browser dan lihat permintaan persisnya serta JSON yang dikembalikan.

Endpoint apa saja yang bisa dipakai?

Base URL-nya adalah https://dashboard.hotelier.tools/api/v1. Daftar lengkap dan terbarunya ada di spesifikasi OpenAPI yang publik. Berikut yang paling sering dipakai di awal:

MetodePathYang Anda dapatkan
GET/reservationsReservasi berdasarkan tanggal check-in, status dan limit opsional
GET/reservations/{id}Detail lengkap satu reservasi (id numerik atau referensi LH…)
GET/reservations/{id}/invoicesInvoice dari sebuah reservasi
GET/reservations/{id}/invoices/{invoiceId}/downloadSatu invoice dalam bentuk PDF
POST/reservations/{id}/invoicesMembuat invoice baru di Little Hotelier (tanpa email ke tamu)
GET/guestsPencarian tamu berdasarkan teks, nama, email, atau telepon
GET/pricesTarif dan ketersediaan untuk rentang tanggal
GET/room-typesTipe kamar beserta jumlah kamar masing-masing
GET/methodsMetode mentah Little Hotelier yang bisa Anda panggil (publik)
POST/methods/{methodName}Menjalankan salah satunya, misalnya getReservationsByDateRange

Beberapa contoh yang bisa disalin langsung (tanggal dan ID hanya karangan):

bash
# Checked-out reservations with check-in in November 2026
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
  "https://dashboard.hotelier.tools/api/v1/reservations?startDate=2026-11-01&endDate=2026-11-30&status=checked_out&limit=100"

# Everything about one booking
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
  "https://dashboard.hotelier.tools/api/v1/reservations/LH00000000000001"

# Rates and availability for a week
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
  "https://dashboard.hotelier.tools/api/v1/prices?startDate=2026-12-01&endDate=2026-12-07"

# Find a guest by surname
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
  "https://dashboard.hotelier.tools/api/v1/guests?lastName=Garcia&perPage=50"

# Every reservation overlapping a range (raw method, named params)
curl -X POST "https://dashboard.hotelier.tools/api/v1/methods/getReservationsByDateRange" \
  -H "Authorization: Bearer htk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{"startDate":"2026-11-01","endDate":"2026-11-30"}}'

Panggilan daftar mengembalikan JSON seperti { "success": true, "count": 2, "data": [ … ] }. Untuk mencoba metode mentah tanpa kode, buka LH Methods (/methods) di dashboard dan jalankan dari browser. Setiap eksekusi tercatat di Run History.

Workbench metode Little Hotelier di Hotelier Tools dengan satu kartu per metode mentah, seperti getReservations, getReservationDetails, getReservationsByDateRange, addPaymentRecord, updateReservation, dan generateInvoice, masing-masing dengan jumlah parameternya
Jalankan metode mentah Little Hotelier mana pun secara manual sebelum Anda membuat skripnya.

Coba di demo langsung

Buka layar yang sama di demo Hotelier Tools, berisi data rekaan. Tanpa mendaftar, tanpa instalasi.

Batas, error, dan hal yang tidak tersedia

Batas laju. 100 permintaan per menit per alamat IP. Setiap respons menyertakan X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset. Jika melewati batas, Anda mendapat 429 dengan header Retry-After.

Paginasi. /reservations mengembalikan maksimal 100 per panggilan (limit, default 50) dan memfilter berdasarkan tanggal check-in. Untuk data setahun, ambil per bulan; jika satu bulan mengembalikan tepat 100, bagi menjadi dua. /guests memakai page dan perPage (hingga 50). /prices memecah rentang yang lebih panjang dari dua minggu menjadi beberapa bagian, jadi rentang panjang lebih lambat.

Error dikembalikan sebagai JSON dengan statusCode dan statusMessage:

KodeBiasanya berarti
401Key tidak ada, salah, atau sudah dicabut
404Reservasi tidak ada, atau bukan milik properti Anda
422Ada parameter yang salah, misalnya tanggal tidak dalam format YYYY-MM-DD
429Terlalu banyak permintaan; tunggu sesuai Retry-After
500 / 502Little Hotelier tidak menjawab; coba lagi nanti

Data yang disamarkan tetap disamarkan. API membaca apa yang masih disimpan Little Hotelier. Little Hotelier menyamarkan data tamu 180 hari setelah check-out, dan tidak ada API yang bisa mengembalikannya. Ekspor sebelum waktu itu.

Tidak tersedia: webhook keluar atau notifikasi real-time, sandbox key publik, dan paket SDK di npm atau PyPI. Untuk menjalankan sesuatu secara terjadwal, gunakan penjadwal Anda sendiri (cron job, Windows Task Scheduler, atau trigger Google Sheets).

Penulisan data itu nyata. POST /reservations/{id}/invoices membuat dokumen invoice baru di Little Hotelier setiap kali Anda memanggilnya. Mulailah dengan panggilan hanya-baca, dan jauhkan key dari spreadsheet bersama dan kode publik.

Apa yang bisa Anda bangun dengannya?

  • Sheet reservasi yang selalu terbarui. Tarik data masa inap bulan lalu ke Google Sheets atau Excel secara terjadwal: lihat ekspor reservasi ke Excel dan Google Sheets.
  • Paket untuk akuntan. Unduh PDF invoice per reservasi, atau lewati kodenya dengan ZIP per kuartal di unduh semua invoice sekaligus.
  • Dashboard. Alirkan okupansi dan pendapatan ke Looker Studio atau Power BI dari sheet yang dijaga tetap terbarui oleh API.
  • Asisten AI. Key yang sama bekerja dengan MCP server Hotelier Tools (https://dashboard.hotelier.tools/api/mcp), yang memberi Claude, ChatGPT, Cursor, atau VS Code lebih dari 100 tool hotel. Mulailah dengan apa itu MCP server, lalu hubungkan Claude atau siapkan Claude Code, Cursor, dan VS Code.
  • Penghubung antar-tool. Jika tidak ada aplikasi App Store, skrip kecil dapat memindahkan data antara Little Hotelier dan sisa sistem Anda. Bandingkan opsinya di integrasi Little Hotelier terbaik.

Langkah berikutnya

  • Jika Anda membuat software untuk banyak hotel, daftarlah ke program mitra SiteMinder dan SMX.
  • Jika Anda hanya butuh data properti Anda sendiri, buat key Hotelier Tools di /developer/api-keys dan panggil /reservations.
  • Ekspor data tamu yang perlu Anda simpan sebelum Little Hotelier menyamarkannya pada hari ke-180.
  • Semua yang ditawarkan API dan MCP server ada di halaman fitur API & MCP.

Pertanyaan umum

Apakah Little Hotelier punya API publik untuk reservasi saya?

Tidak ada yang bisa dipakai properti untuk reservasinya sendiri, per Oktober 2026. API SiteMinder diperuntukkan bagi mitra teknologi bersertifikasi, dan API key Direct Booking yang bisa Anda buat sendiri hanya mencakup tarif, ketersediaan, dan detail properti untuk situs pemesanan.

Apa itu SiteMinder Exchange (SMX), dan apakah mencakup Little Hotelier?

SMX adalah API SiteMinder untuk aplikasi mitra seperti check-in, pesan tamu, dan tool revenue. Panduan pengembang SiteMinder mencantumkan Little Hotelier sebagai sumber reservasi untuk SMX, tetapi bukan sumber ketersediaan dan tarif. Hanya mitra bersertifikasi yang dapat terhubung.

Bagaimana cara menjadi mitra integrasi SiteMinder, dan berapa lama prosesnya?

Anda mengirim formulir pendaftaran integrasi SiteMinder, menandatangani perjanjian kemitraan, lalu membangun, mensertifikasi, dan meluncurkan integrasi. SiteMinder menyebut sebagian besar integrasi memerlukan sekitar 60 hari dari awal hingga live. Jalur ini ditujukan bagi perusahaan software, bukan satu hotel.

Apakah API tidak resmi seperti Hotelier Tools aman dan diizinkan?

Hotelier Tools masuk memakai login Little Hotelier Anda sendiri, menyimpannya terenkripsi (AES-256-GCM), dan hanya bisa melakukan apa yang bisa dilakukan login tersebut di aplikasi web Little Hotelier. Ini bukan integrasi resmi SiteMinder, jadi jika ragu, periksa perjanjian Anda sendiri dengan SiteMinder. Anda dapat mencabut setiap key kapan saja.

Apakah Little Hotelier punya MCP server untuk asisten AI?

Belum ada untuk pemilik, per Oktober 2026. Pekerjaan AI SiteMinder di Demand Plus berfokus pada wisatawan yang menemukan dan memesan kamar Anda lewat ChatGPT dan Claude. Untuk bertanya ke AI tentang reservasi Anda sendiri, Anda memerlukan MCP server independen seperti yang ada di Hotelier Tools.

Bisakah saya menguji API tanpa risiko pada data asli?

Tidak ada sandbox key publik. Mulailah dengan panggilan hanya-baca (reservasi, harga, tipe kamar). Panggilan itu tidak mengubah apa pun di Little Hotelier. Panggilan yang menulis, seperti membuat invoice, menghasilkan dokumen sungguhan.

Bagikan

Semua ini ada di dasbor Hotelier Tools

Faktur, pemeriksaan, harga, pesan tamu, dan laporan INE untuk Little Hotelier. Gratis sampai 10 Januari 2027.