API Khách sạn

Tìm kiếm

POST /v1/hotels/search with a destination and check-in/out dates and one to eight rooms (adults and child ages per room). The destination is a cityCode (IATA-style, e.g. "DXB" — GET /v1/content/cities lists them), a list of hotelCodes from the catalogue you store on your side (GET /v1/content/hotels per city), or a geo circle. Name matching is yours to do against your stored list; availability is always asked by code.

Với wait=true bạn nhận toàn bộ tập kết quả; với wait=false bạn nhận một searchId để thăm dò bằng GET /v1/hotels/search/{searchId} — hãy truyền cùng ngày và số phòng để các rate key vẫn đặt được. Mỗi khách sạn mang nội dung của nó (tên, hạng sao, địa chỉ, tọa độ, ảnh chính, tiện nghi) và mức giá rẻ nhất cho mỗi phòng với một rateKey mờ, tổng giá và giá theo đêm, chế độ ăn, khả năng hoàn tiền và hạn chót hủy miễn phí.

Phòng và giá

GET /v1/hotels/{hotelCode}/rooms?rateKey=… liệt kê mọi loại phòng và mức giá của một cơ sở lưu trú cho kỳ lưu trú đã tìm: loại giường, sức chứa, chế độ ăn, chính sách, thuế và phí được tách riêng, và mức giá có hoàn tiền được hay không.

Kiểm tra giá

POST /v1/hotels/rates/{rateKey}/check xác nhận mức giá vẫn đặt được và trả về giá cuối cùng cùng chính sách. Hãy làm việc này ngay trước khi đặt: một lỗi 409 price_changed hoặc rate_expired ở bước này rẻ hơn nhiều so với một lượt đặt thất bại.

Đặt phòng

POST /v1/hotels/bookings với rateKey, người đứng tên, khách cho từng phòng và người liên hệ, kèm Idempotency-Key. Phản hồi là đặt phòng với mã tham chiếu, xác nhận của nhà cung cấp và dữ liệu voucher. GET /v1/hotels/bookings/{bookingId} trả lại thông tin này bất cứ lúc nào.

Hủy

GET /v1/hotels/bookings/{bookingId}/cancellation-quote trả về khoản phạt theo chính sách tại thời điểm này; POST /v1/hotels/bookings/{bookingId}/cancel (bắt buộc Idempotency-Key) thực hiện việc hủy.