Online Booking API
เชื่อมต่อระบบจองห้องพัก (booking engine) บนเว็บไซต์ของโรงแรมเข้ากับ HMS: รายการห้องพักและราคา ห้องว่างตามปฏิทิน คูปอง การชำระเงิน และการส่งการจอง
- URL หลัก
https://test.hms.gen.tr- การยืนยันตัวตน
- apiKey / apiSecret → Bearer token
- รูปแบบ
- ตอบกลับเป็น JSON · เนื้อหาคำขอแบบฟอร์มหรือ JSON
- ขอบเขต
- 8 ทรัพยากร · 16 เอนด์พอยต์
แหล่งข้อมูล#
การยืนยันตัวตน
1 เอนด์พอยต์การเข้าถึง Online Booking API ใช้ข้อมูลรับรองของพาร์ทเนอร์ที่ HMS ออกให้ เอนด์พอยต์เข้าสู่ระบบจะแลก apiKey และ apiSecret เป็นโทเค็น ซึ่งต้องส่งเป็น Au…
- POST
/external/public/login
ห้องพักและราคา
2 เอนด์พอยต์เอนด์พอยต์สองตัวที่อยู่เบื้องหลังผลการค้นหาของระบบจองห้องพัก ได้แก่ รายการห้องพัก ซึ่งส่งคืนประเภทห้องพักที่เปิดขาย แผนอาหาร และราคาสำหรับวันที่และจำน…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
การจอง
1 เอนด์พอยต์ห้องพัก แผนอาหาร และราคาที่ผู้เข้าพักเลือกจะถูกส่งไปยัง HMS ในโครงสร้าง BookingPushRQ เอนด์พอยต์เดียวกันนี้ใช้สำหรับการยกเลิกและการแก้ไขด้วย โดยส่ง ty…
- POST
/external/online/channel/booking
การชำระเงิน
3 เอนด์พอยต์แสดงรายการประเภทการชำระเงินที่โรงแรมรับสำหรับการจองออนไลน์ และเริ่มขั้นตอนการชำระเงินสำหรับประเภทที่เลือก สิ่งที่ต้องทำในแต่ละประเภทอธิบายไว้ในคู่มือข…
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
คูปอง
1 เอนด์พอยต์ตรวจสอบคูปองส่วนลดออนไลน์ที่โรงแรมกำหนดไว้ในแผงควบคุม ให้คำนวณส่วนลดในฝั่งของคุณ แล้วส่งยอดเงินหลังหักส่วนลดในการส่งการจอง
- POST
/external/online/coupon/search
แพ็กเกจและบริการเสริม
1 เอนด์พอยต์บริการเสริมที่ขายพร้อมการจองได้ ได้แก่ แพ็กเกจห้องพัก (ผูกกับประเภทห้องพัก) และแพ็กเกจทั่วไป (รถรับส่ง อาหารเย็น สปา) แพ็กเกจที่ขายจะส่งไปกับการส่งการ…
- GET
/external/stock/packages
ข้อมูลโรงแรม
4 เอนด์พอยต์ข้อมูลสำหรับส่วนประกอบของหน้าเว็บระบบจองห้องพัก ได้แก่ ข้อมูลติดต่อและที่ตั้ง ลิงก์โซเชียลมีเดีย ข้อความส่วนท้าย (ข้อกฎหมาย เกี่ยวกับโรงแรม โค้ด Analy…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +อีก 1 รายการ
ข้อมูลพื้นฐาน
3 เอนด์พอยต์รายการคงที่สำหรับตัวเลือกในแบบฟอร์ม ได้แก่ ประเทศ สกุลเงิน และภาษา ข้อมูลเหล่านี้เปลี่ยนแปลงไม่บ่อยและแคชไว้ได้หนึ่งวัน
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
เอกสาร#
เริ่มต้นใช้งาน
- ภาพรวมOnline Booking API ทำอะไรได้บ้าง URL หลัก ภาพรวมขั้นตอน และกฎทั่วไป
- เริ่มต้นอย่างรวดเร็วรับโทเค็นด้วยข้อมูลรับรองของพาร์ทเนอร์ แล้วส่งคำขอค้นหาห้องพักและราคาครั้งแรก
- การยืนยันตัวตนการเข้าสู่ระบบด้วย apiKey / apiSecret, Bearer token, บริบทของโรงแรม และอายุของโทเค็น
- คำขอและการตอบกลับเนื้อหาแบบฟอร์มและ JSON, โครงสร้าง success, การแบ่งหน้า, รูปแบบวันที่และจำนวนเงิน และรหัสสถานะ HTTP
- รหัสข้อผิดพลาดค่า message และ errorCode, ข้อผิดพลาดในการยืนยันตัวตน และแนวทางการลองใหม่