API โรงแรม

ค้นหา

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.

เมื่อใช้ wait=true คุณจะได้ผลลัพธ์ทั้งหมด เมื่อใช้ wait=false จะได้ searchId เพื่อ poll ด้วย GET /v1/hotels/search/{searchId} — ส่งวันที่และจำนวนห้องเดิมเพื่อให้คีย์ราคายังจองได้ แต่ละโรงแรมมีข้อมูล (ชื่อ ระดับดาว ที่อยู่ พิกัด รูปหลัก สิ่งอำนวยความสะดวก) และราคาถูกที่สุดต่อห้องพร้อม rateKey ที่เป็นค่าทึบ ราคารวมและราคาต่อคืน ประเภทอาหาร การขอคืนเงินได้ และกำหนดเวลายกเลิก

ห้องพักและราคา

GET /v1/hotels/{hotelCode}/rooms?rateKey=… แสดงทุกประเภทห้องและราคาของที่พักหนึ่งแห่งสำหรับช่วงเข้าพักที่ค้นหา: ประเภทเตียง จำนวนผู้เข้าพัก ประเภทอาหาร นโยบาย ภาษีและค่าธรรมเนียมแยกรายการ และราคานั้นขอคืนเงินได้หรือไม่

ตรวจสอบราคา

POST /v1/hotels/rates/{rateKey}/check ยืนยันว่าราคายังจองได้และส่งคืนราคาและนโยบายสุดท้าย ให้ทำทันทีก่อนจอง: 409 price_changed หรือ rate_expired ในขั้นนี้เสียหายน้อยกว่าการจองที่ล้มเหลวมาก

จอง

POST /v1/hotels/bookings พร้อม rateKey ผู้ถือการจอง ผู้เข้าพักต่อห้อง และผู้ติดต่อ รวมถึง Idempotency-Key การตอบกลับคือการจองพร้อมเลขอ้างอิง การยืนยันจากซัพพลายเออร์ และข้อมูลวอเชอร์ GET /v1/hotels/bookings/{bookingId} ส่งคืนข้อมูลนี้อีกครั้งได้ทุกเมื่อ

ยกเลิก

GET /v1/hotels/bookings/{bookingId}/cancellation-quote ส่งคืนค่าปรับตามนโยบาย ณ ขณะนั้น POST /v1/hotels/bookings/{bookingId}/cancel (ต้องมี Idempotency-Key) ยืนยันการยกเลิก