ทดลองใช้งานจริง

การเชื่อมต่อซัพพลายเออร์โรงแรม

การเชื่อมต่อ Hotelbeds API: คอนเทนต์ การแมป และการจองแบบเรียลไทม์

การเชื่อมต่อ Hotelbeds API คืองานสองส่วน ไม่ใช่ส่วนเดียว คุณต้องดาวน์โหลดและจัดเก็บคอนเทนต์โรงแรม แล้วจึงจองด้วยราคาแบบเรียลไทม์ PHPTRAVELS ทำทั้งสองส่วนในโมดูลโรงแรม โดยใช้สัญญาและคีย์ Hotelbeds ของคุณเอง

  • ซิงก์ Content API
  • ขั้นตอน Booking API
  • ราคา BOOKABLE และ RECHECK
  • การแมปโรงแรม

API ของ Hotelbeds ทำงานร่วมกันอย่างไร

การเชื่อมต่อ Hotelbeds API: ฝั่งหนึ่งคือคอนเทนต์ อีกฝั่งคือการจอง

Hotelbeds แบ่ง API โรงแรมออกเป็นสองส่วน Content API ส่งข้อมูลคงที่ ได้แก่ คำอธิบาย รูปภาพ สิ่งอำนวยความสะดวก ประเภทอาหาร และห้องพัก Booking API ส่งห้องว่างและราคาแบบเรียลไทม์ และรับการจอง เลือกขั้นตอนตรงกลางเพื่อดูว่าใช้การเรียกใดบ้าง

Content API

ข้อมูลคงที่ จัดเก็บในฝั่งของคุณ
  • รายชื่อโรงแรมhotels · from=1&to=1000โรงแรมทั้งหมดในพอร์ตโฟลิโอของคุณ แบ่งเป็นหน้า หน้าละไม่เกิน 1,000 โรงแรมต่อคำขอ
  • สิ่งอำนวยความสะดวก ประเภทอาหาร และห้องพักfacilities · boards · roomsตารางรหัสที่แปลงรหัสจาก Booking API เป็นคำที่ผู้เข้าพักเข้าใจ
  • รูปภาพphotos.hotelbeds.com/giata/พาธรูปภาพบางส่วน นำไปต่อกับโฮสต์รูปภาพของ Hotelbeds ในขนาดที่ต้องการ
  • การเปลี่ยนแปลงรายวันlastUpdateTimeหลังโหลดครั้งแรก ส่งคำขอวันละครั้งพร้อม lastUpdateTime เพื่อรับเฉพาะข้อมูลที่เปลี่ยนแปลง

ขั้นตอนคำขอ

Booking API

เรียลไทม์ เรียกต่อผู้เข้าพักแต่ละราย
  • ค้นหาห้องว่างPOST /hotelsห้องพัก ประเภทอาหาร ราคา และค่าธรรมเนียมการยกเลิก ตามรหัสโรงแรม วันที่ และจำนวนผู้เข้าพัก
  • ตรวจสอบราคาPOST /checkratesราคาและเงื่อนไขล่าสุดสำหรับราคาที่ระบุว่า RECHECK พร้อมตัวเลือกอัปเกรด
  • การจองPOST /bookingsยืนยัน rateKey ที่เลือกด้วยชื่อผู้จองและผู้เข้าพัก แล้วส่งหมายเลขการจองกลับมา
  • การยกเลิกDELETE /bookings · simulateจำลองการยกเลิกเพื่อแสดงค่าธรรมเนียม หรือยกเลิกการจองจริง
หน้าจอตัวอย่าง การเรียกเป็นไปตามเอกสารบน developer.hotelbeds.com ส่วนขั้นตอนคือวิธีที่ PHPTRAVELS ใช้งาน

โปรเจกต์ Hotelbeds ที่ล้มเหลวส่วนใหญ่มักปะปนสองส่วนนี้เข้าด้วยกัน บางโปรเจกต์เรียก Content API ระหว่างที่ผู้เข้าพักค้นหา ซึ่งช้า และตามที่ Hotelbeds เตือนไว้ อาจทำให้ข้อมูลรับรองถูกบล็อก บางโปรเจกต์ค้นหาแบบเรียลไทม์โดยไม่มีรหัสที่จัดเก็บไว้ จึงแสดงรูปภาพหรือสิ่งอำนวยความสะดวกไม่ได้ PHPTRAVELS แยกสองส่วนนี้ออกจากกัน คอนเทนต์ซิงก์อยู่เบื้องหลัง และมีเพียงการค้นหาห้องว่าง การตรวจสอบราคา และการจองเท่านั้นที่ทำงานขณะผู้เข้าพักรอ

หากต้องการทราบเกี่ยวกับซัพพลายเออร์ ผลิตภัณฑ์ และวิธีเปิดบัญชี โปรดอ่าน ข้อมูลซัพพลายเออร์ Hotelbeds หน้านี้กล่าวถึงการเชื่อมต่อทางเทคนิค

ประเภทราคา

ฟิลด์ราคาสี่ฟิลด์ที่เปลี่ยนขั้นตอนชำระเงินของคุณ

ราคาของ Hotelbeds ทุกรายการมีแอตทริบิวต์ที่กำหนดว่าคุณจองได้ทันทีหรือไม่ แสดงราคาใดได้ และใครเป็นผู้รับเงิน ต่อไปนี้คือฟิลด์ที่เอนจินของคุณต้องอ่านในทุกผลลัพธ์

ฟิลด์กรณีที่หนึ่งกรณีที่สองสิ่งที่ PHPTRAVELS ทำ

จองได้ทันทีหรือต้องตรวจสอบ

rateType		BOOKABLE

ราคาเป็นปัจจุบัน คุณจองได้โดยไม่ต้องเรียกเพิ่ม

RECHECK

คุณต้องเรียกตรวจสอบราคาก่อนเพื่อรับราคาและเงื่อนไขล่าสุด

ตรวจสอบราคา RECHECK ก่อนขั้นตอนชำระเงิน และแสดงการเปลี่ยนแปลงให้ผู้เข้าพักเห็น

ราคาสุทธิหรือราคาค่าคอมมิชชัน

net · sellingRate		net

รูปแบบราคาสุทธิ: ราคาเป็นราคาสุทธิ คุณบวกกำไรเอง

sellingRate

รูปแบบค่าคอมมิชชัน: ค่าคอมมิชชันรวมอยู่ใน sellingRate แล้ว และเป็นราคาสุดท้าย

ใช้กฎการบวกราคาของคุณกับราคาสุทธิ และขายราคาค่าคอมมิชชันที่ sellingRate

ราคาขายคงที่

hotelMandatory		true

hotelMandatory เป็น true: คุณต้องขายที่ sellingRate

false · null

เป็น false หรือว่างในราคาสุทธิ: คุณกำหนดกำไรเองได้

ล็อกราคาที่แสดงไว้ที่ sellingRate เมื่อโรงแรมกำหนด ไม่ว่ากฎการบวกราคาจะเป็นอย่างไร

ผู้เข้าพักชำระเงินเมื่อใด

paymentType		AT_WEB

รับชำระเงินเมื่อทำการจองผ่านเว็บไซต์ของคุณ

AT_HOTEL

ผู้เข้าพักชำระเงินกับโรงแรมโดยตรง

ติดป้ายราคาว่าชำระทันทีหรือชำระที่โรงแรม และปรับขั้นตอนชำระเงินให้ตรงกัน

รูปแบบราคาที่คุณได้รับขึ้นอยู่กับสัญญา Hotelbeds ของคุณ ตามที่ Hotelbeds ระบุ ผู้จัดการฝ่ายขายของคุณจะแนะนำรูปแบบที่เหมาะกับธุรกิจของคุณ

การแมปโรงแรม

จับคู่โรงแรม Hotelbeds กับโรงแรมที่คุณขายอยู่แล้ว

หากคุณมีสัญญาของตัวเองหรือมีซัพพลายเออร์รายที่สอง โรงแรมเดียวกันจะเข้ามาด้วยรหัสที่ต่างกัน การแมปจะเชื่อมโยงรหัสเหล่านั้น ผู้เข้าพักจึงเห็นโรงแรมเดียวพร้อมราคาดีที่สุด ไม่ใช่สามรายการซ้ำกัน

การแมปทำงานอย่างไรใน PHPTRAVELS

หลังการซิงก์คอนเทนต์แต่ละครั้ง PHPTRAVELS จะเปรียบเทียบโรงแรม Hotelbeds กับรายชื่อโรงแรมของคุณตามชื่อ ที่อยู่ เมือง และพิกัด รายการที่ใกล้เคียงกันมากจะเชื่อมโยงโดยอัตโนมัติ รายการที่ไม่แน่ใจจะรอให้เจ้าหน้าที่ยืนยัน และโรงแรมที่ไม่มีคู่สามารถนำเข้าเป็นที่พักใหม่หรือข้ามไปได้

โรงแรมที่แมปแล้วจะใช้หน้าเดียว แกลเลอรีเดียว และคะแนนรีวิวเดียวกันใน ที่พัก ขณะที่ซัพพลายเออร์แต่ละรายยังคงราคาและกฎของตนเอง การแมปชุดเดียวกันนี้ใช้ทั้งในเว็บไซต์สาธารณะและ พอร์ทัลท่องเที่ยว B2B ของคุณ

การแมปโรงแรม
  • Harbour View Hotelลิสบอน48291397%จับคู่แล้ว
  • Old Town Suitesปราก11735492%จับคู่แล้ว
  • Palm Court Resortดูไบ66201874%ตรวจสอบ
  • Casa Azul Boutiqueเซบียา–0%ไม่มีคู่
  • Northern Lights Lodgeทรอมโซ90522766%ตรวจสอบ
  • Riverside Apartmentsบูดาเปสต์33076198%จับคู่แล้ว

หน้าจอตัวอย่างที่ใช้โรงแรมและรหัสสมมติ

Hotelbeds XML หรือ JSON

ทุกคำขอต้องลงนาม และการทดสอบเริ่มจากขนาดเล็ก

หลายทีมยังค้นหาคำว่า Hotelbeds XML แต่เอกสารปัจจุบันแสดงคำขอแบบ JSON ไม่ว่าแบบใดก็เป็นชุดการทำงานเดียวกัน และทุกคำขอมีเฮดเดอร์สองตัว

availability-request.sh (ตัวอย่าง)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
เฮดเดอร์สองตัว
Api-key ใส่คีย์ของคุณ และ X-Signature คือแฮช SHA256 ของคีย์ ซีเคร็ต และเวลาปัจจุบันเป็นวินาที
โฮสต์ทดสอบ
ตามที่ Hotelbeds ระบุ เซิร์ฟเวอร์ทดสอบเหมือนกับระบบจริง แต่การจองในนั้นไม่ใช่การจองจริงและไม่มีการเรียกเก็บเงินจากบัตร
50 คำขอต่อวัน
คีย์ใหม่จะเปิดใช้สภาพแวดล้อมประเมินผลที่มีโควตา 50 คำขอต่อวัน โควตาเพิ่มขึ้นหลังผ่านการรับรอง
ไม่เรียกคอนเทนต์แบบเรียลไทม์
Hotelbeds เตือนว่าการเรียก Content API แบบเรียลไทม์อาจทำให้ข้อมูลรับรองถูกบล็อก PHPTRAVELS ไม่เคยทำเช่นนั้น

เครื่องมือวางแผนการซิงก์คอนเทนต์

รายชื่อโรงแรมของคุณต้องใช้การเรียก Content API กี่ครั้ง

ตามที่ Hotelbeds ระบุ รายชื่อโรงแรมแบ่งเป็นหน้า หน้าละไม่เกิน 1,000 โรงแรม และหลังโหลดครั้งแรก คำขอ lastUpdateTime วันละครั้งจะส่งเฉพาะการเปลี่ยนแปลง กรอกตัวเลขของคุณเพื่อวางแผนการซิงก์

จำนวนคำขอสำหรับการโหลดเต็มครั้งแรก
20
จำนวนคำขอต่อการอัปเดตรายวัน
3
จำนวนวันที่ใช้โหลดหนึ่งรอบด้วยโควตาประเมินผล
1

เป็นเพียงการประมาณสำหรับรายชื่อโรงแรม ตารางรหัสและรูปภาพจะเพิ่มการเรียกอีกเล็กน้อย ด้วยโควตาประเมินผล 50 คำขอต่อวัน ควรทดสอบกับปลายทางเดียวก่อน

เช็กลิสต์ก่อนเปิดใช้งานจริง

สิ่งที่ต้องเตรียมก่อนเปลี่ยนเป็นระบบจริง

Hotelbeds พาคุณจากขั้นประเมินผลไปสู่การรับรอง แล้วจึงได้คีย์ระบบจริงผ่านแดชบอร์ด ต่อไปนี้คือประเด็นที่การเชื่อมต่อ Hotelbeds API ควรครอบคลุมก่อน และวิธีที่ PHPTRAVELS รองรับ

  • เพิ่มคีย์ประเมินผลในหน้าผู้ดูแลระบบ และเลือกโฮสต์ทดสอบ
  • ซิงก์ Content API ลงฐานข้อมูลแล้ว และตั้งเวลาอัปเดตรายวัน
  • แมปโรงแรมกับรายชื่อของคุณแล้ว และตรวจสอบรายการที่ไม่แน่ใจ
  • ราคา RECHECK ผ่านการตรวจสอบราคาก่อนชำระเงิน
  • ใช้ sellingRate เมื่อ hotelMandatory เป็น true
  • แสดงหมายเหตุราคาและค่าธรรมเนียมการยกเลิกก่อนผู้เข้าพักชำระเงิน
  • วอเชอร์แสดงหมายเลขการจอง Hotelbeds และหมายเหตุราคา
  • จำลองการยกเลิกก่อน แล้วจึงยืนยัน พร้อมบันทึกค่าธรรมเนียม

ขั้นตอนการรับรองและการเข้าถึงระบบจริงกำหนดโดย Hotelbeds ตามสัญญาและตลาดของคุณ

ค่าใช้จ่าย

ไลเซนส์เดียวสำหรับเอนจิน สัญญากับ Hotelbeds เป็นของคุณเอง

PHPTRAVELS เป็นไลเซนส์แบบชำระครั้งเดียวพร้อมซอร์สโค้ด Hotelbeds เป็นข้อตกลงแยกระหว่างคุณกับ Hotelbeds ดังนั้นราคาสุทธิและคีย์จึงเป็นของคุณ

สตาร์ทอัพ
ไลเซนส์ครั้งเดียว
ไลเซนส์ชำระครั้งเดียว
เอเจนซี
ไลเซนส์ครั้งเดียว
ไลเซนส์ชำระครั้งเดียว
องค์กร
ไลเซนส์ครั้งเดียว
ไลเซนส์ชำระครั้งเดียว

Hotelbeds เป็นหนึ่งในแหล่งโรงแรมหลายแห่งที่คุณใช้งานควบคู่กันได้ ดูว่าทำงานร่วมกับ RateHawk อย่างไรในภาพรวม API ท่องเที่ยว หรือเปรียบเทียบซัพพลายเออร์ใน รายชื่อซัพพลายเออร์ XML

ดูราคาลองเดโมโรงแรม

คำถามที่พบบ่อย

คำถามเกี่ยวกับการเชื่อมต่อ Hotelbeds API

สิ่งที่นักพัฒนาและบริษัทท่องเที่ยวถามก่อนเชื่อมต่อ Hotelbeds

คุยกับฝ่ายขาย

มีสองส่วน ส่วนแรกคือการซิงก์เบื้องหลังด้วย Content API ที่จัดเก็บโรงแรม รูปภาพ สิ่งอำนวยความสะดวก ประเภทอาหาร และห้องพักในฐานข้อมูลของคุณ ส่วนที่สองคือขั้นตอนแบบเรียลไทม์ด้วย Booking API สำหรับค้นหาห้องว่าง ตรวจสอบราคา จอง และยกเลิก PHPTRAVELS ทำงานทั้งสองส่วนในโมดูลโรงแรม

หลายคนยังเรียกว่า Hotelbeds XML แต่เอกสาร Hotelbeds ปัจจุบันแสดงคำขอและการตอบกลับแบบ JSON การทำงานเหมือนกันทั้งสองแบบ และ PHPTRAVELS จัดการรูปแบบให้คุณ

ราคา BOOKABLE เป็นปัจจุบันแล้วและจองได้ทันที ราคา RECHECK ต้องเรียกตรวจสอบราคาก่อน ซึ่งจะส่งราคาและเงื่อนไขปัจจุบันกลับมา PHPTRAVELS เรียกขั้นตอนนี้ก่อนขั้นตอนชำระเงิน

เพราะช้า และ Hotelbeds เตือนว่าการใช้ Content API แบบเรียลไทม์อาจทำให้ข้อมูลรับรองถูกบล็อก ควรดาวน์โหลดคอนเทนต์เป็นหน้า จัดเก็บไว้ และอัปเดตวันละครั้งด้วย lastUpdateTime ซึ่งเป็นวิธีที่ PHPTRAVELS ทำงาน

ต้องมี คุณลงทะเบียนกับ Hotelbeds ลงนามในสัญญา และรับ API key และซีเคร็ตของคุณเอง คีย์ใหม่ใช้งานในสภาพแวดล้อมประเมินผล 50 คำขอต่อวันจนกว่าคุณจะผ่านการรับรอง

ได้ การแมปโรงแรมเชื่อมโยงที่พักเดียวกันจากหลายแหล่ง ผู้เข้าพักจึงเห็นโรงแรมเดียวพร้อมราคาดีที่สุดที่มี ขณะที่แต่ละแหล่งยังคงการบวกราคาและกฎของตนเอง

แพ็กเกจ PHPTRAVELS เริ่มต้นที่ เป็นไลเซนส์ชำระครั้งเดียวพร้อมซอร์สโค้ด สัญญา Hotelbeds ของคุณแยกต่างหากและตกลงกับ Hotelbeds โดยตรง ดูหน้าราคาหรือติดต่อฝ่ายขายเพื่อขอใบเสนอราคา

สำรวจต่อ

เพิ่มเติมเกี่ยวกับแพลตฟอร์ม