Quy Tắc
Chống trùng theo
requestId— gửi lại cùngrequestIdvà cùngpayloadtrong 10 phút thì nhận lại đúng response cũ, không xử lý lần hai. Khi retry vì timeout, giữ nguyênrequestId, chỉ đổitimestampvà ký lại. Chỉ áp dụng choprice-check,bookings/create,bookings/commit,bookings/cancel.Chống trùng theo
partnerReference—bookings/createvớipartnerReferenceđã có booking sẽ trả lại booking đó.Timeout ở
createhoặccommit— không tạo booking mới. Gọibookings/gettheopartnerReferenceđể biết trạng thái thật.Commit song song — nếu một
bookings/commitkhác cho cùng booking đang chạy, Gotadi trả mã01và không trừ tiền lần hai. Nếu Gotadi đã trừ tiền nhưng bước sau gặp lỗi, kết quả là09 PENDING, không phải lỗi: đừng hoàn tiền cho khách, tra lại bằngbookings/get.Giá — giá ở
availabilityvàofferslà giá tham khảo có cache. Giá chỉ chốt ởprice-check; khách trả đúngtotalAmountcủa booking.price.totallà tổng cả kỳ ở, mọi phòng, đã gồm thuế (taxAndFees).totalBeforePromocùng cơ sở vớitotal, chỉ có khipromo = true.Thời hạn —
offerId30 phút,bookingToken15 phút, thanh toán trướcpaymentDeadlinetrong responsecreate.Giới hạn —
availabilitytối đa 50masterIds, 30 đêm, 8 phòng. Tần suất gọi theo hợp đồng; vượt thì nhận HTTP 429 từ gateway.Content — đồng bộ toàn bộ danh mục theo
countryCodevàcursor, lưu ở hệ thống đối tác. Không gọicontent/propertiestrong luồng tìm của khách.Dữ liệu cá nhân — tên, email, số điện thoại khách chỉ dùng cho booking, không ghi log dạng rõ.