Cổng thông tin nhà phát triểnPhần mềm khách sạn HMS

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 Bearer hoặc header ApiKey
Đị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
Yêu cầu
# 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"
Phản hồi · 200 (rút gọn)
{
    "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
}

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.

Đã 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.

8 tài nguyên · 16 endpointTài liệu
Đã phát hành

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ỳ.

1 tài nguyên · 1 endpointTài liệu
Sắp ra mắt

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.

Tài liệu đang được chuẩn bị
Sắp ra mắt

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.

Tài liệu đang được chuẩn bị
Sắp ra mắt

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.

Tài liệu đang được chuẩn bị
Sắp ra mắt

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ài liệu đang được chuẩn bị
Sắp ra mắt

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.

Tài liệu đang được chuẩn bị

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.

Xác thực

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.

Yêu cầu và phản hồi

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 API

Thay đổi gần đây

Toàn bộ nhật ký thay đổi

  • Trang web
    Hỗ trợ 22 ngôn ngữ
    MớiMới
  • Hotspot
    Đã phát hành tài liệu Hotspot API
    MớiMới
  • Online Booking
    Đã phát hành tài liệu Online Booking API
    Mớ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.