Online Booking API
Menghubungkan booking engine di situs web hotel ke HMS: daftar kamar dan tarif, ketersediaan kalender, kupon, pembayaran, dan pengiriman reservasi.
- URL dasar
https://test.hms.gen.tr- Autentikasi
- apiKey / apiSecret → Bearer token
- Format
- Respons JSON · body permintaan form atau JSON
- Cakupan
- 8 sumber daya · 16 endpoint
Sumber daya#
Autentikasi
1 endpointAkses ke Online Booking API menggunakan kredensial mitra yang diterbitkan oleh HMS. Endpoint login menukar apiKey dan apiSecret dengan token, yang dik…
- POST
/external/public/login
Kamar dan tarif
2 endpointDua endpoint yang menyediakan data untuk hasil pencarian booking engine: daftar kamar, yang mengembalikan tipe kamar yang dapat dijual, meal plan, dan…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Reservasi
1 endpointKamar, meal plan, dan tarif yang dipilih tamu dikirim ke HMS dalam struktur BookingPushRQ. Endpoint yang sama juga menangani pembatalan dan perubahan …
- POST
/external/online/channel/booking
Pembayaran
3 endpointMenampilkan jenis pembayaran yang diterima hotel untuk reservasi online dan memulai langkah pembayaran untuk jenis yang dipilih. Langkah untuk setiap …
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Kupon
1 endpointMemvalidasi kupon diskon online yang ditetapkan hotel di panel. Terapkan diskon di sisi Anda, lalu kirim jumlah setelah diskon dalam pengiriman reserv…
- POST
/external/online/coupon/search
Paket dan ekstra
1 endpointEkstra yang dapat dijual bersama reservasi: paket kamar (terkait dengan tipe kamar tertentu) dan paket umum (transfer, makan malam, spa). Paket yang t…
- GET
/external/stock/packages
Informasi hotel
4 endpointData yang mengisi kerangka halaman booking engine: detail kontak dan lokasi, tautan media sosial, teks footer (legal, tentang hotel, snippet analytics…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 lainnya
Data acuan
3 endpointDaftar statis untuk opsi form: negara, mata uang, dan bahasa. Data ini jarang berubah dan dapat di-cache selama satu hari.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Dokumentasi#
Memulai
- IkhtisarFungsi Online Booking API, URL dasar, ringkasan alur, dan aturan umum.
- Mulai cepatDapatkan token dengan kredensial mitra Anda, lalu kirim kueri kamar dan tarif pertama Anda.
- AutentikasiLogin dengan apiKey / apiSecret, Bearer token, konteks hotel, dan masa berlaku token.
- Permintaan dan responsBody form dan JSON, envelope success, paginasi, format tanggal dan jumlah, kode status HTTP.
- Kode errorNilai message dan errorCode, error autentikasi, dan panduan percobaan ulang.