Online Booking API
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 endpointHai 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 endpointPhò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 endpointLiệ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 endpointKiể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 endpointCá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 endpointDữ 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 endpointDanh 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
- Tổng quanOnline Booking API làm gì, URL gốc, tóm tắt luồng và quy tắc chung.
- Bắt đầu nhanhLấy token bằng thông tin xác thực đối tác và gửi truy vấn phòng và giá đầu tiên.
- Xác thựcĐăng nhập bằng apiKey / apiSecret, Bearer token, ngữ cảnh khách sạn và thời hạn token.
- Yêu cầu và phản hồiNội dung dạng form và JSON, lớp bọc success, phân trang, định dạng ngày và số tiền, mã trạng thái HTTP.
- Mã lỗiGiá trị message và errorCode, lỗi xác thực và hướng dẫn thử lại.