Open API v1

สร้างร่วมกับ ElefyMove

เชื่อมต่อแพลตฟอร์มของคุณเข้ากับ ElefyMove เพื่อลงประกาศที่พัก ซิงค์ห้องว่างแบบเรียลไทม์ และไม่มีวันจองซ้ำวันเดียวกันสองครั้ง

เข้าสู่ระบบ / รับ API keyดูเอกสาร API

API ทำอะไรได้บ้าง

จุดเชื่อมต่อเดียวสำหรับประกาศที่พัก ห้องว่าง และการซิงค์แบบเรียลไทม์

Listings API

ส่งประกาศที่พักหลายภาษาเข้าสู่ ElefyMove ได้โดยตรง ส่งเนื้อหาได้ในภาษาใดก็ได้จาก 9 ภาษาที่เรารองรับ ทุกประกาศจะถูกตรวจสอบก่อนเผยแพร่จริง

การซิงค์ห้องว่าง

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

การกันห้องชั่วคราว

กันห้องไว้ชั่วคราวได้นานสูงสุด 10 นาที ระหว่างที่แขกกำลังชำระเงินฝั่งของคุณ หากมีคำขอชนกัน ระบบจะให้สิทธิ์ตามลำดับคำขอที่มาถึงก่อน โดยคำขอที่มาทีหลังจะได้รับสถานะ 409 ที่ระบบอ่านค่าต่อได้

Webhooks

สมัครรับอีเวนต์ที่เซ็นด้วย HMAC-SHA256 สำหรับการอนุมัติประกาศ การเปลี่ยนแปลงห้องว่าง วงจรของการกันห้อง และสถานะการจอง ส่งถึงคุณใกล้เคียงเรียลไทม์ เพย์โหลดมีเฉพาะวันที่และหมายเลขอ้างอิงเท่านั้น ไม่มีข้อมูลส่วนบุคคลของแขก

การซิงค์ iCal

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

พาร์ตเนอร์ทำอะไรได้บ้าง — และทำอะไรไม่ได้

กฎข้อแรก: ทุกการทำงานผ่าน API จำกัดอยู่เฉพาะข้อมูลของคุณเองเท่านั้น ไม่มีการเข้าถึงข้อมูลข้ามพาร์ตเนอร์ไม่ว่าทิศทางใด

ทำได้

  • สร้าง แก้ไข และถอดประกาศที่พักของคุณเองได้ ในภาษาใดก็ได้จาก 9 ภาษาที่เรารองรับ
  • อ่านประกาศของคุณเองและสถานะการตรวจสอบ
  • อ่านห้องว่างของประกาศของคุณเอง และเขียนบล็อกจากช่องทางภายนอกพร้อมหมายเลขอ้างอิง
  • กันห้องไว้ชั่วคราวและปล่อยคืนได้ นานสูงสุด 10 นาที ระหว่างการชำระเงินฝั่งของคุณ
  • ลงทะเบียน webhook และรับอีเวนต์ที่เซ็นรับรอง — มีเฉพาะวันที่และหมายเลขอ้างอิงเท่านั้น
  • ส่งออกปฏิทินประกาศ (iCal) และลงทะเบียนฟีด iCal ของคุณเอง
  • อ่านโครงสร้างพื้นที่ตั้งสาธารณะ

ทำไม่ได้

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

การขอสิทธิ์เข้าถึง

สร้างบัญชีนักพัฒนา ยืนยันอีเมล แล้วออก API key ของคุณเองได้จากแดชบอร์ดทันที ส่วนการเผยแพร่ประกาศจริงต้องให้ทีม ElefyMove เชื่อมโยง key ของคุณกับบัญชีผู้ให้เช่าที่ยืนยันแล้วก่อน

สร้าง API key ของคุณ

การสร้างบัญชีถือว่าคุณยอมรับข้อกำหนดการใช้งาน API

ขอบเขตสิทธิ์ที่มีให้

listings:readlistings:writeavailability:readavailability:writeholds:writewebhooks:manage

อัตราจำกัดค่าเริ่มต้น: 120 คำขอต่อนาทีต่อคีย์

เริ่มต้นใช้งานอย่างรวดเร็ว

ทุกคำขอต้องยืนยันตัวตนด้วยเฮดเดอร์ X-Api-Key ที่มีคีย์ที่คุณได้รับ

ตรวจสอบห้องว่างของประกาศ

curl "https://elefymove.com/api/public/v1/listings/{listingId}/availability?from=2026-09-01&to=2026-09-30" \
  -H "X-Api-Key: efy_live_xxxxxxxxxxxxxxxxxxxxxxxx"

# Response — 200 OK
[
  { "from": "2026-09-01", "to": "2026-09-14", "state": "AVAILABLE" },
  { "from": "2026-09-15", "to": "2026-09-20", "state": "BLOCKED", "source": "partner-site", "externalRef": "HMXYZ123" },
  { "from": "2026-09-21", "to": "2026-09-30", "state": "AVAILABLE" }
]

กันห้องไว้ชั่วคราว

curl -X POST "https://elefymove.com/api/public/v1/listings/{listingId}/holds" \
  -H "X-Api-Key: efy_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"from": "2026-09-15", "to": "2026-09-20", "ttlSeconds": 300}'

# Response — 201 Created
{ "holdId": "hld_9f3a2c1b", "expiresAt": "2026-08-13T10:15:00Z" }

คำขอที่แพ้จะได้รับสถานะ 409 ที่ระบบอ่านค่าต่อได้

# Same request, the dates were just taken by another channel
# Response — 409 Conflict
{
  "code": "SLOT_TAKEN",
  "conflictingState": "HELD",
  "wonBy": "external"
}
OpenAPI / Swagger

เอกสาร API ฉบับเต็ม

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

เปิดเอกสาร APIอ่านเอกสารประกอบฉบับเต็ม

ทุกเอนด์พอยต์ในที่เดียว

ครบทุกเอนด์พอยต์ของ Open API v1 ทุกคำขอต้องแนบคีย์ของคุณในเฮดเดอร์ X-Api-Key และทุกเส้นทางเข้าถึงได้เฉพาะข้อมูลของคุณเองเท่านั้น

URL หลัก https://elefymove.com

ประกาศที่พัก

เมธอดเอนด์พอยต์สโคปใช้ทำอะไร
POST/api/public/v1/listingslistings:writeส่งประกาศใหม่เข้าสู่การตรวจสอบ ใส่เนื้อหาได้ในภาษาใดก็ได้จาก 9 ภาษาที่รองรับ
GET/api/public/v1/listingslistings:readดูรายการประกาศทั้งหมดที่คีย์ของคุณเป็นเจ้าของ พร้อมสถานะการตรวจสอบล่าสุด
GET/api/public/v1/listings/{externalId}listings:readอ่านประกาศของคุณหนึ่งรายการด้วยรหัสภายนอกที่คุณกำหนดไว้
PATCH/api/public/v1/listings/{externalId}listings:writeแก้ไขประกาศของคุณ ฟิลด์ที่ไม่ได้ส่งมาจะคงค่าเดิมไว้
DELETE/api/public/v1/listings/{externalId}listings:writeนำประกาศของคุณออกจากการแสดงผล

ปฏิทินว่างและการบล็อกวันที่

เมธอดเอนด์พอยต์สโคปใช้ทำอะไร
GET/api/public/v1/listings/{id}/availabilityavailability:readอ่านปฏิทินรวมของประกาศตามช่วงวันที่ — ว่าง จองชั่วคราว จองแล้ว หรือถูกบล็อก
POST/api/public/v1/listings/{id}/blocksavailability:writeสร้างหรือแก้ไขการบล็อกวันที่จากช่องทางภายนอก โดยระบุรหัสอ้างอิงของคุณเอง
DELETE/api/public/v1/listings/{id}/blocks/{externalRef}availability:writeลบการบล็อกวันที่จากช่องทางภายนอกที่คุณเคยสร้างไว้

การจองชั่วคราว

เมธอดเอนด์พอยต์สโคปใช้ทำอะไร
POST/api/public/v1/listings/{id}/holdsholds:writeจองวันที่ไว้ชั่วคราวระหว่างที่ผู้เข้าพักชำระเงินฝั่งคุณ คำขอที่ช้ากว่าจะได้รับ 409 พร้อมรหัส SLOT_TAKEN
DELETE/api/public/v1/holds/{id}holds:writeปล่อยการจองชั่วคราวของคุณก่อนหมดเวลา

ซิงก์ปฏิทิน (iCal)

เมธอดเอนด์พอยต์สโคปใช้ทำอะไร
GET/api/public/v1/listings/{id}/calendar.icsURL ที่ลงลายเซ็น ไม่ต้องใช้คีย์ดาวน์โหลดปฏิทินของประกาศเป็นฟีด iCal โทเค็นที่ลงลายเซ็นใน URL ทำหน้าที่ยืนยันตัวตน แอปปฏิทินจึงสมัครรับได้โดยตรง
PUT/api/public/v1/listings/{id}/ical-sourcesavailability:writeลงทะเบียนหรือเปลี่ยนฟีด iCal ขาเข้าที่ ElefyMove จะดึงข้อมูลให้ประกาศของคุณ
GET/api/public/v1/listings/{id}/ical-sourcesavailability:readอ่านฟีดที่ลงทะเบียนไว้ของประกาศ พร้อมสถานะการดึงข้อมูลและข้อผิดพลาดล่าสุด
DELETE/api/public/v1/listings/{id}/ical-sourcesavailability:writeหยุดดึงข้อมูลและลบฟีดที่ลงทะเบียนไว้ของประกาศ

เว็บฮุก

เว็บฮุกใน v1 ยังไม่มีเอนด์พอยต์ให้พาร์ตเนอร์เรียกเอง ส่ง URL ปลายทางของคุณมาพร้อมคำขอคีย์ แล้วทีมงาน ElefyMove จะลงทะเบียนให้ พร้อมคีย์ลับ HMAC-SHA256 ที่ใช้ลงลายเซ็นทุกครั้งที่ส่ง หากส่งไม่สำเร็จระบบจะลองใหม่โดยเว้นระยะห่างขึ้นเรื่อย ๆ และเพย์โหลดมีเพียงวันที่กับรหัสอ้างอิงเท่านั้น

อีเวนต์ที่รับได้
listing.approvedlisting.rejectedavailability.changedhold.createdhold.releasedhold.expiredbooking.createdbooking.cancelledping

ทั่วไป

เมธอดเอนด์พอยต์สโคปใช้ทำอะไร
GET/api/public/v1/pingคีย์ที่ใช้งานได้ทุกคีย์ตรวจสอบว่าคีย์ของคุณใช้งานได้ พร้อมดูชื่อไคลเอ็นต์และสโคปที่ผูกไว้

ข้อมูลและการใช้งานอย่างเป็นธรรม

  • ไม่มีข้อมูลส่วนบุคคลของแขกไหลผ่าน API เลย การบล็อกจากภายนอกมีเพียงวันที่และหมายเลขอ้างอิงเท่านั้น สอดคล้องกับกฎหมาย PDPA ของไทย
  • ประกาศที่มาจาก API จะลิงก์กลับไปยังหน้าต้นฉบับบน elefymove.com เสมอ
  • คีย์ทุกดวงถูกกำหนดขอบเขตไว้ และทีมงาน ElefyMove สามารถเพิกถอนได้ทุกเมื่อ

Open API v1 — ขณะนี้อยู่ระหว่างรับพาร์ตเนอร์เข้าร่วมทดสอบระบบ