Online Booking API

Đã phát hànhHMS API V2API 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.

URL gốc
https://test.hms.gen.tr
Xác thực
apiKey / apiSecret → Bearer token
Định dạng
Phản hồi JSON · nội dung yêu cầu dạng form hoặc JSON
Phạm vi
8 tài nguyên · 16 endpoint

Tài nguyên#

Xác thực

1 endpoint

Để truy cập Online Booking API, bạn dùng thông tin xác thực đối tác do HMS cấp. Endpoint đăng nhập đổi apiKey và apiSecret lấy một token; token này đư…

  • POST/external/public/login

Phòng và giá

2 endpoint

Hai endpoint cung cấp dữ liệu cho kết quả tìm kiếm của công cụ đặt phòng: danh sách phòng trả về các loại phòng có thể bán, gói ăn và giá cho ngày và …

  • POST/external/online/roomType
  • GET/external/room/type/hotel/availability

Đặt phòng

1 endpoint

Phòng, gói ăn và giá mà khách đã chọn được gửi đến HMS theo cấu trúc BookingPushRQ. Cùng endpoint này cũng xử lý việc hủy và sửa đổi khi bạn gửi type …

  • POST/external/online/channel/booking

Thanh toán

3 endpoint

Liệt kê các hình thức thanh toán mà khách sạn chấp nhận cho đặt phòng trực tuyến và bắt đầu bước thanh toán cho hình thức đã chọn. Việc cần làm với từ…

  • GET/external/online/payment/type
  • GET/external/payment/company
  • POST/external/online/payment/type/{paymentType}

Mã giảm giá

1 endpoint

Kiểm tra các mã giảm giá trực tuyến mà khách sạn đã tạo trong bảng quản trị. Hãy tự áp dụng mức giảm ở phía bạn và gửi các số tiền đã giảm khi gửi đặt…

  • POST/external/online/coupon/search

Gói dịch vụ và dịch vụ bổ sung

1 endpoint

Các dịch vụ bổ sung có thể bán kèm đặt phòng: gói phòng (gắn với một loại phòng) và gói chung (đưa đón, bữa tối, spa). Các gói đã bán được gửi kèm đặt…

  • GET/external/stock/packages

Thông tin khách sạn

4 endpoint

Dữ liệu cho phần khung trang của công cụ đặt phòng: thông tin liên hệ và vị trí, liên kết mạng xã hội, nội dung chân trang (pháp lý, giới thiệu, đoạn …

  • GET/external/hotel/{hotelID}/contact/info
  • GET/external/online/social/media
  • GET/external/online/footer
  • +1 mục khác

Danh mục

3 endpoint

Danh sách cố định cho các tùy chọn trong form: quốc gia, tiền tệ và ngôn ngữ. Ít khi thay đổi và có thể lưu vào bộ nhớ đệm trong một ngày.

  • POST/external/counties
  • GET/external/currencies
  • GET/external/languages

Tài liệu#

Bắt đầu

Hướng dẫn

Cập nhật lần cuối: 21 tháng 9, 2026Phát hiện lỗi? Hãy cho chúng tôi biết