Hỗ trợ
Liên hệ đội ngũ phát triển của chúng tôi về bất kỳ vấn đề nào cản trở việc tích hợp. Bạn nên xem trang Mã lỗi của sản phẩm trước; phần lớn câu hỏi đã được giải đáp ở đó.
Câu hỏi kỹ thuật, báo lỗi, yêu cầu khóa đối tác và khách sạn thử nghiệm. Phản hồi trong vòng một ngày làm việc.
Điện thoại
Thứ Hai–Thứ Sáu 09:00–18:00 (GMT+3). Dành cho sự cố gián đoạn ảnh hưởng đến môi trường chính thức.
Khóa đối tác
Để truy cập, bạn cần một tài khoản đối tác do HMS cấp. Hãy gửi email cho chúng tôi thông tin công ty và các khách sạn bạn sẽ tích hợp; bạn sẽ nhận được apiKey, apiSecret và một ID khách sạn cho môi trường thử nghiệm.
Khi báo lỗi, hãy gửi kèm
- Sản phẩm và endpoint (ví dụ Online Booking ·
POST /external/online/roomType) - Toàn bộ nội dung yêu cầu và phản hồi, đã che
apiSecret, token và dữ liệu thẻ - Thời điểm gửi yêu cầu (kèm múi giờ) và
hotelID - Kết quả bạn mong đợi và sự cố có tái hiện được hay không
Câu hỏi thường gặp
Tôi cần gì để sử dụng API?
Một tài khoản đối tác do HMS cấp (apiKey / apiSecret) và quyền truy cập khách sạn mà bạn tích hợp. Mô-đun liên quan (ví dụ kênh đặt phòng trực tuyến) phải được kích hoạt ở phía khách sạn.
Có môi trường thử nghiệm không?
Có. Các ví dụ trong tài liệu này dùng môi trường thử nghiệm (test.hms.gen.tr); chúng tôi cung cấp một bản ghi khách sạn và khóa đối tác trên môi trường này để phát triển. Địa chỉ và khóa của môi trường chính thức được cấp khi tích hợp được phê duyệt.
Tôi nhận được lỗi 401.
Token bị thiếu, đã hết hạn, thiếu tiền tố Bearer hoặc thuộc về khách sạn khác. Hãy đăng nhập lại và thử lại. Nếu đăng nhập trả về success: false, hãy kiểm tra message: cặp khóa sai hoặc không có quyền với khách sạn.
Danh sách phòng trả về rỗng hoặc roomCount bằng 0.
Kênh trực tuyến của khách sạn đang đóng (errorCode 10003), không có loại phòng nào mở bán (10004) hoặc có hạn chế về ngày/số khách. Với các phòng có roomCount bằng 0, roomRestrictionMessage cho biết lý do (thời gian lưu trú tối thiểu, đóng nhận phòng, chưa thiết lập giá).
Tôi đã gửi đặt phòng nhưng không thấy trong bảng quản trị.
Kiểm tra xem có Error trong BookingPushRS không. Hotel registration not found on HMS. nghĩa là khách sạn chưa liên kết với kênh trực tuyến; Could not register. thường do roomTypeID / ratePlanID không hợp lệ hoặc ngày tháng không nhất quán.
Khi nào API của các mô-đun khác được phát hành?
Tài liệu cho POS nhà hàng, Spa, AI, TV và Tổng đài đang được lần lượt bổ sung. Ngày phát hành được thông báo trong nhật ký thay đổi; hãy liên hệ với chúng tôi nếu bạn muốn truy cập sớm một mô-đun cụ thể.