Portal pengembangPerangkat Lunak Hotel HMS

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 Bearer atau header ApiKey
Format
Respons JSON dengan envelope success
Tersedia
2 produk · 17 endpoint
Segera hadir
5 produk
Permintaan
# 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"
Respons · 200 (dipotong)
{
    "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
}

Produk

Setiap produk memiliki dokumentasi, referensi API, dan contoh kode sendiri. Produk yang akan datang diumumkan di catatan rilis saat sudah tersedia.

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.

Autentikasi

Envelope success

Respons berformat JSON dan memuat penanda success. Error aturan bisnis dikembalikan sebagai HTTP 200 dengan message atau errorCode; error autentikasi berupa 401.

Permintaan dan respons

Contoh siap pakai

Contoh cURL, Node.js, dan PHP dibuat untuk setiap endpoint; salin, tambahkan kunci Anda, lalu jalankan.

Referensi API

Perubahan terbaru

Semua catatan rilis

  • Situs
    Dukungan 22 bahasa
    BaruBaru
  • Hotspot
    Dokumentasi Hotspot API diterbitkan
    BaruBaru
  • Online Booking
    Dokumentasi Online Booking API diterbitkan
    BaruBaruBaru

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.