Hubungkan perangkat lunak Anda ke modul HMS
Dokumentasi API terpisah untuk setiap modul perangkat lunak hotel: booking engine, Wi-Fi tamu, POS restoran, spa, TV, PBX, dan layanan AI. API Online Booking dan Hotspot sudah tersedia; modul lainnya menyusul.
- Autentikasi
- Token
Beareratau headerApiKey - Format
- Respons JSON dengan envelope
success - Tersedia
- 2 produk · 17 endpoint
- Segera hadir
- 5 produk
# Kueri kamar dan tarif
curl "https://test.hms.gen.tr/external/online/roomType" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
-d "adultCount=2"# Daftar tamu yang sedang menginap
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"success": true,
"items": [
{
"id": 2,
"name": "Kamar Standar",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Termasuk Sarapan",
"prices": {
"2-1": {
"total": 2,
"price": "1930.00",
"nonRefundable": ""
},
"2-0": {
"total": 2,
"price": "1737.00",
"nonRefundable": "[NR]"
}
}
}
]
}
],
"count": 1
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}Produk
Setiap produk memiliki dokumentasi, referensi API, dan contoh kode sendiri. Produk yang akan datang diumumkan di catatan rilis saat sudah tersedia.
Online Booking
API booking engine
Menghubungkan booking engine di situs web hotel ke HMS: daftar kamar dan tarif, ketersediaan kalender, kupon, pembayaran, dan pengiriman reservasi.
Hotspot
Wi-Fi tamu dan log UU No. 5651
Menyediakan daftar tamu yang sedang menginap untuk sistem hotspot: kamar, identitas, waktu check-in dan check-out. Digunakan untuk memverifikasi login Wi-Fi tamu dengan nomor kamar dan menyimpan log akses sesuai Undang-Undang Turki No. 5651.
POS Restoran
Bill dan tagihan ke kamar
Posting bill restoran, bar, dan kafe ke folio kamar, serta sinkronisasi menu dan stok.
Spa
Janji temu dan penjualan layanan
Janji temu spa dan wellness, katalog layanan, dan integrasi tagihan ke kamar.
AI
Layanan asisten dan rekomendasi
Akses ke layanan AI untuk asisten tamu, rekomendasi tarif, dan pelaporan.
TV
Sistem TV dalam kamar
Data tamu, folio, pesan, dan permintaan layanan untuk antarmuka TV dalam kamar.
PBX
PBX dan catatan panggilan
Integrasi PBX: mengaktifkan dan menonaktifkan saluran telepon saat check-in/out, serta posting biaya panggilan ke folio.
Prinsip yang sama untuk semua produk
Setelah Anda mengintegrasikan satu modul, modul lainnya akan terasa familier.
Kunci terikat hotel
Di Online Booking, apiKey/apiSecret yang diterbitkan HMS ditukar dengan Bearer token yang terikat ke hotel dan berlaku 7 hari. Integrasi on-premise seperti Hotspot menggunakan kunci yang dibuat di panel hotel itu sendiri, dan kunci ini dikirim sebagai header ApiKey pada setiap permintaan.
Envelope success
Respons berformat JSON dan memuat penanda success. Error aturan bisnis dikembalikan sebagai HTTP 200 dengan message atau errorCode; error autentikasi berupa 401.
Contoh siap pakai
Contoh cURL, Node.js, dan PHP dibuat untuk setiap endpoint; salin, tambahkan kunci Anda, lalu jalankan.
Referensi APIPerubahan terbaru
-
Dukungan 22 bahasaBaruBaru
-
Dokumentasi Hotspot API diterbitkanBaruBaru
-
Dokumentasi Online Booking API diterbitkanBaruBaruBaru
Mengalami kendala?
Tim pengembang kami membalas dalam satu hari kerja.
Sertakan body permintaan (dengan secret dan data kartu disamarkan), respons, dan waktunya. Gunakan alamat yang sama untuk permintaan kunci mitra, hotel uji, dan akses awal.