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

API ที่พัก

API ที่พัก สำหรับโรงแรม อพาร์ตเมนต์ และบ้านพักตากอากาศ

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

  • ที่พัก ยูนิต แผนราคา ปฏิทิน
  • คืนขั้นต่ำและค่าธรรมเนียม
  • ช่วงเวลายกเลิก
  • สต็อกของคุณเองและซัพพลายจาก API

โมเดลข้อมูล

สี่ชั้นภายในทุกการเข้าพัก

ไม่ว่าจะเป็นโรงแรม 300 ห้องหรือบ้านริมหาดหลังเดียว API ที่พักอธิบายด้วยโครงสร้างซ้อนกันสี่ชั้นแบบเดียวกัน แต่ละชั้นตอบคำถามที่แขกถามก่อนจองคนละข้อ

01ที่พัก

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

property_id · type · address · geo · photos · amenities · check_in_from

02ห้องหรือยูนิต

สิ่งที่ถูกจองจริง: ประเภทห้อง อพาร์ตเมนต์ทั้งห้อง หรือเตียงในห้องรวม พร้อมขนาด เตียง และจำนวนผู้เข้าพักสูงสุด

unit_id · beds · size_m2 · max_adults · max_children

03แผนราคา

วิธีขายยูนิตนั้น: มื้ออาหาร นโยบายยกเลิก เงื่อนไขการชำระเงิน และผู้ที่จองได้ เช่น ทั่วไปหรือเฉพาะเอเจนต์

rate_plan_id · board · cancel_policy · payment · channel

04ห้องว่าง

หนึ่งแถวต่อคืน: ราคา จำนวนยูนิตที่เหลือ คืนขั้นต่ำ และวันนั้นอนุญาตให้เช็คอินหรือเช็คเอาต์หรือไม่

date · price · units_left · min_stay · closed_to_arrival

อาคาร ห้องพัก ป้ายราคา และปฏิทิน วาดเป็นชั้นซ้อนกันแยกกันของรายการที่พักหนึ่งรายการ

PHPTRAVELS เรียกโมดูลที่พักว่า Stays เพราะโมเดลเดียวกันครอบคลุมได้มากกว่าโรงแรมมาก ที่พักหนึ่งแห่งมีหลายยูนิต ยูนิตขายผ่านแผนราคาตั้งแต่หนึ่งแผนขึ้นไป และแต่ละแผนราคามีปฏิทินราคาและห้องว่างรายคืน เมื่อจัดสี่ชั้นนี้ให้ถูกต้อง เตียงในโฮสเทล สวีทในโรงแรม และวิลลาสามห้องนอนจะใช้การค้นหาและขั้นตอนชำระเงินชุดเดียวกันได้

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

ทีละคืน

ปฏิทินห้องว่างคือจุดที่การขายที่พักชนะหรือแพ้

API ที่พักทุกตัวลงเอยที่ปฏิทิน การค้นหาจะส่งที่พักกลับมาก็ต่อเมื่อทุกคืนในช่วงที่ขอยังว่าง มีราคา และเป็นไปตามกฎการเข้าพัก

อพาร์ตเมนต์สองห้องนอน · ราคามาตรฐานพฤศจิกายน 2026 · ราคาต่อคืน
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • ว่าง คิดราคารายคืน
  • จองแล้ว
  • เจ้าของปิดไว้
  • คืนขั้นต่ำจากวันเช็คอินนี้
  • ปิดไม่รับเช็คอิน

ข้อมูลตัวอย่าง แบบย่อ

  • ราคาคิดเป็นต่อคืนราคารวมของการเข้าพักคือผลรวมของแต่ละคืน ดังนั้นคืนวันศุกร์และเสาร์ที่เป็นราคาสุดสัปดาห์จึงแพงกว่าสองคืนวันธรรมดา ราคาตามวันและฤดูกาลอยู่ในปฏิทิน ไม่ใช่ในที่พัก
  • กฎคืนขั้นต่ำเงื่อนไขขั้นต่ำสามคืนสำหรับการเช็คอินวันศุกร์ จะซ่อนยูนิตจากการค้นหาสองคืน บ้านเช่าใช้กฎนี้บ่อยกว่าโรงแรมมาก และมักเข้มงวดกว่าในวันหยุดสุดสัปดาห์และช่วงไฮซีซัน
  • ปิดรับเช็คอินหรือเช็คเอาต์บางคืนจองได้ถ้าเป็นส่วนหนึ่งของการพักที่ยาวกว่า แต่จองเป็นคืนแรกหรือคืนสุดท้ายไม่ได้ วันเปลี่ยนแขกของบ้านพักตากอากาศทำงานแบบนี้
  • คืนที่ปิดและ stop-sellเจ้าของปิดวันที่ไว้ใช้เองหรือซ่อมบำรุง ส่วน stop-sell จะถอดยูนิตออกจากการขายทันที คืนที่ปิดเพียงคืนเดียวในช่วงวันที่ที่ขอจะทำให้ยูนิตหายจากผลการค้นหา

ที่พักไม่ได้มีแค่โรงแรม

โรงแรม อพาร์ตเมนต์ และบ้านพักตากอากาศ ต่างกันอย่างไร

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

โรงแรม

รวมโฮสเทลและเกสต์เฮาส์

สิ่งที่ถูกจอง
ประเภทห้องที่มีห้องเหมือนกันหลายห้อง หรือเตียงในห้องรวม
การตั้งราคา
ราคาต่อคืนตามห้องและมื้ออาหาร ผู้ใหญ่หรือเด็กเพิ่มอาจทำให้ราคาเปลี่ยน
กฎการเข้าพัก
คืนขั้นต่ำเฉพาะช่วงวันที่ยอดนิยม ส่วนใหญ่จองทีละคืนได้
ค่าธรรมเนียมและเงินมัดจำ
ภาษีเมืองหรือภาษีการท่องเที่ยว บางครั้งมีค่ารีสอร์ตที่จ่ายที่พัก
การมาถึง
เคาน์เตอร์ต้อนรับเปิด 24 ชั่วโมงหรือมีเจ้าหน้าที่ เวลาเช็คอินบนวอเชอร์ก็เพียงพอ
แหล่งที่มาโดยทั่วไป
เบดแบงก์และผู้ค้าส่ง สัญญาโดยตรง ช่องทางผ่านแชนเนลเมเนเจอร์

เซอร์วิสอพาร์ตเมนต์

อพาร์ตโฮเทลและอพาร์ตเมนต์ในเมือง

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

บ้านพักตากอากาศ

บ้านพักตากอากาศ วิลลา และกระท่อม

สิ่งที่ถูกจอง
บ้านหลังใดหลังหนึ่งโดยเฉพาะ ปกติมีเพียงหลังเดียว
การตั้งราคา
ราคาต่อคืนสำหรับทั้งหลัง บวกค่าธรรมเนียมต่อแขกที่เกินจำนวนพื้นฐาน
กฎการเข้าพัก
คืนขั้นต่ำ วันเปลี่ยนแขกที่แน่นอน และวันที่ปิดรับเช็คอินเป็นเรื่องปกติ
ค่าธรรมเนียมและเงินมัดจำ
ค่าทำความสะอาด เงินมัดจำความเสียหายที่คืนได้ และภาษีท้องถิ่น แสดงแยกทุกรายการก่อนชำระเงิน
การมาถึง
คำแนะนำการเช็คอิน ที่อยู่ และช่องทางติดต่อ จะส่งก่อนวันมาถึง และไม่แสดงบนหน้าสาธารณะ
แหล่งที่มาโดยทั่วไป
เจ้าของและผู้จัดการทรัพย์สิน ทั้งโดยตรงหรือผ่านแชนเนลเมเนเจอร์

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

ช่วงเวลาตามนโยบายยกเลิก

หนึ่งการจอง สามช่วงเวลายกเลิก

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

จองเช็คอิน
  1. 01 · ถึง 14 วันก่อนเช็คอินยกเลิกฟรีแขกยกเลิกและได้เงินคืนเต็มจำนวน นี่คือกำหนดเวลาที่นักเดินทางมองหาเป็นอย่างแรก จึงควรแสดงเป็นวันที่ ไม่ใช่เป็นกฎ
  2. 02 · 14 ถึง 3 วันก่อนค่าปรับบางส่วนมีค่าปรับ มักเป็นคืนแรกหรือเปอร์เซ็นต์ของราคาที่พัก บ้านเช่าอาจยึดเงินมัดจำในช่วงนี้
  3. 03 · 3 วันสุดท้ายและไม่มาเข้าพักไม่คืนเงินยึดเงินเต็มจำนวน แผนราคาที่ขายแบบไม่คืนเงินจะอยู่ในช่วงนี้ตั้งแต่ตอนจอง
ตัวอย่างช่วงเวลา แต่ละแผนราคามีของตัวเอง
  • ตามแผนราคา ไม่ใช่ตามที่พักอพาร์ตเมนต์เดียวกันอาจมีทั้งราคายืดหยุ่นและราคาที่ถูกกว่าแต่ไม่คืนเงิน นโยบายจึงอยู่ที่ชั้นแผนราคา
  • วันที่ตามเขตเวลาของที่พัก“14 วันก่อน” นับจากวันเช็คอินตามเวลาของที่ตั้งที่พัก ควรแปลงเป็นวันที่และเวลาที่ชัดเจนบนหน้าเว็บและวอเชอร์
  • นโยบายของซัพพลายเออร์มาก่อนกับสต็อกจาก API คุณเสนอเงื่อนไขที่ผ่อนปรนกว่าที่ซัพพลายเออร์ให้ไม่ได้ ส่วนสัญญาของคุณเอง คุณกำหนดช่วงเวลาเองได้

สต็อกของคุณเองและสต็อกจาก API

ที่พักที่คุณทำสัญญาและ API ซัพพลายเออร์ ในการค้นหาเดียว

ผู้ขายที่พักส่วนใหญ่ทำทั้งสองอย่าง คือโหลดที่พักที่ทำสัญญาเองและเพิ่ม API ซัพพลายเออร์สำหรับที่เหลือ นักเดินทางไม่ควรรู้เลยว่าที่พักมาจากแหล่งใด

ที่พักของคุณเอง

  • โหลดที่พัก ยูนิต และแผนราคาเองในหลังบ้าน
  • ให้เจ้าของและโรงแรมล็อกอินเอ็กซ์ทราเน็ตเพื่อจัดการปฏิทินของตน
  • กำหนดราคา คืนขั้นต่ำ วันที่ปิด และช่วงเวลายกเลิก
  • โควตาห้องพักพร้อมวันปล่อยคืนและ stop-sell
  • หรือรับราคาและห้องว่างจากแชนเนลเมเนเจอร์

สต็อกจาก API ซัพพลายเออร์

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

สิ่งที่แขกได้รับ

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

การเชื่อมต่อแชนเนลเมเนเจอร์อธิบายไว้ใน เชื่อมต่อ Channel Manager ส่วนห้องที่คุณถือครองตามสัญญา ดู ระบบสต็อกการจอง

พร้อมใช้ใน PHPTRAVELS

ซัพพลายเออร์ที่พักที่เชื่อมต่อแล้ว

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

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

จองที่พักแบบเดียวกับที่แขกของคุณจะทำ

ค้นหา เปรียบเทียบราคา และจองในเดโมสด แล้วบอกเราว่าคุณวางแผนจะขายที่พักและซัพพลายเออร์รายใด

ลองเดโมสดสอบถามเรื่องซัพพลายเออร์ของคุณ

กำลังสร้างแอปของคุณเองหรือฟีดสำหรับพาร์ตเนอร์อยู่ใช่หรือไม่ REST API ของ PHPTRAVELS ให้บริการแหล่งที่พักที่เชื่อมต่อทั้งหมดในรูปแบบเดียว พร้อม webhook สำหรับเหตุการณ์การจอง มาพร้อมแผน Enterprise ดู ราคา และเอกสารสำหรับนักพัฒนา ภาพรวมที่กว้างกว่าอยู่ที่ API ท่องเที่ยว

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

API ที่พัก: คำถามที่นักพัฒนาและเอเจนซีถามบ่อย

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

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

การเรียกหลักเหมือนกัน แต่ API ที่พักต้องจัดการสิ่งที่ที่พักนอกเหนือจากโรงแรมต้องการด้วย ได้แก่ การจองทั้งยูนิต คืนขั้นต่ำและวันเปลี่ยนแขก ค่าแขกเพิ่ม ค่าทำความสะอาด เงินมัดจำที่คืนได้ และคำแนะนำการเช็คอินที่ส่งก่อนวันมาถึง

ได้ ใน PHPTRAVELS โมดูล Stays ใช้โมเดลเดียวคือที่พัก ยูนิต แผนราคา และห้องว่าง สำหรับที่พักทุกประเภท โรงแรม อพาร์ตเมนต์ และบ้านพักตากอากาศจึงปรากฏในการค้นหาเดียวกันพร้อมกฎของตัวเอง

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

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

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

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

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

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

สำรวจต่อ

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