Kết nối phần mềm của bạn với các mô-đun HMS
Tài liệu API riêng cho từng mô-đun của phần mềm khách sạn: công cụ đặt phòng, Wi-Fi cho khách, POS nhà hàng, spa, TV, tổng đài và dịch vụ AI. Online Booking API và Hotspot API đã phát hành; các mô-đun khác sẽ lần lượt ra mắt.
- Xác thực
- Token
Bearerhoặc headerApiKey - Định dạng
- Phản hồi JSON với lớp bọc
success - Đã phát hành
- 2 sản phẩm · 17 endpoint
- Sắp ra mắt
- 5 sản phẩm
# Truy vấn phòng và giá
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"# Danh sách khách đang lưu trú
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": "Phòng Tiêu chuẩn",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Bao gồm bữa sáng",
"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
}
]
}Sản phẩm
Mỗi sản phẩm có tài liệu, tham chiếu API và mã mẫu riêng. Các sản phẩm sắp ra mắt sẽ được thông báo trong nhật ký thay đổi khi phát hành.
Online Booking
API công cụ đặt phòng
Kết nối công cụ đặt phòng trên website của khách sạn với HMS: danh sách phòng và giá, phòng trống theo lịch, mã giảm giá, thanh toán và gửi đặt phòng.
Hotspot
Wi-Fi cho khách và nhật ký theo Luật 5651
Cung cấp danh sách khách đang lưu trú cho hệ thống hotspot: phòng, thông tin nhận dạng, thời điểm nhận phòng và trả phòng. Dùng để xác minh đăng nhập Wi-Fi của khách bằng số phòng và lưu nhật ký truy cập theo Luật số 5651 của Thổ Nhĩ Kỳ.
POS nhà hàng
Hóa đơn và ghi nợ vào phòng
Chuyển hóa đơn nhà hàng, bar và quán cà phê vào folio phòng, đồng bộ thực đơn và tồn kho.
Spa
Lịch hẹn và dịch vụ
Lịch hẹn spa và chăm sóc sức khỏe, danh mục dịch vụ và tích hợp ghi nợ vào phòng.
AI
Dịch vụ trợ lý và gợi ý
Truy cập các dịch vụ AI cho trợ lý khách, gợi ý giá và báo cáo.
TV
Hệ thống TV trong phòng
Thông tin khách, folio, tin nhắn và yêu cầu dịch vụ cho giao diện TV trong phòng.
Tổng đài
Tổng đài và nhật ký cuộc gọi
Tích hợp tổng đài: mở và khóa đường dây khi nhận/trả phòng, ghi cước cuộc gọi vào folio.
Nguyên tắc chung cho mọi sản phẩm
Khi đã tích hợp một mô-đun, bạn sẽ thấy các mô-đun khác rất quen thuộc.
Khóa gắn với khách sạn
Trong Online Booking, apiKey/apiSecret do HMS cấp được đổi lấy một Bearer token gắn với khách sạn, có hiệu lực 7 ngày. Các tích hợp tại chỗ như Hotspot dùng khóa được tạo trong bảng quản trị của chính khách sạn, gửi trong header ApiKey ở mọi yêu cầu.
Lớp bọc success
Phản hồi ở dạng JSON và có cờ success. Lỗi quy tắc nghiệp vụ được trả về dưới dạng HTTP 200 kèm message hoặc errorCode; lỗi xác thực là 401.
Mã mẫu chạy được
Mã mẫu cURL, Node.js và PHP được tạo cho mọi endpoint; chỉ cần sao chép, thêm khóa của bạn và chạy.
Tham chiếu APIThay đổi gần đây
-
Hỗ trợ 22 ngôn ngữMớiMới
-
Đã phát hành tài liệu Hotspot APIMớiMới
-
Đã phát hành tài liệu Online Booking APIMớiMớiMới
Gặp khó khăn?
Đội ngũ phát triển của chúng tôi phản hồi trong vòng một ngày làm việc.
Hãy gửi kèm nội dung yêu cầu (đã che khóa bí mật và dữ liệu thẻ), phản hồi và thời điểm gửi. Bạn cũng dùng địa chỉ này để xin khóa đối tác, khách sạn thử nghiệm và quyền truy cập sớm.