คู่มือและข้อมูลอ้างอิงสำหรับ ElefyMove Open API
ขณะนี้คู่มือเหล่านี้มีเฉพาะภาษาอังกฤษ
| เมธอด | เอนด์พอยต์ | สโคป | ใช้ทำอะไร |
|---|---|---|---|
| GET | /api/public/v1/listings/{id}/calendar.ics | URL ที่ลงลายเซ็น ไม่ต้องใช้คีย์ | ดาวน์โหลดปฏิทินของประกาศเป็นฟีด iCal โทเค็นที่ลงลายเซ็นใน URL ทำหน้าที่ยืนยันตัวตน แอปปฏิทินจึงสมัครรับได้โดยตรง |
| PUT | /api/public/v1/listings/{id}/ical-sources | availability:write | ลงทะเบียนหรือเปลี่ยนฟีด iCal ขาเข้าที่ ElefyMove จะดึงข้อมูลให้ประกาศของคุณ |
| GET | /api/public/v1/listings/{id}/ical-sources | availability:read | อ่านฟีดที่ลงทะเบียนไว้ของประกาศ พร้อมสถานะการดึงข้อมูลและข้อผิดพลาดล่าสุด |
| DELETE | /api/public/v1/listings/{id}/ical-sources | availability:write | หยุดดึงข้อมูลและลบฟีดที่ลงทะเบียนไว้ของประกาศ |
Every listing exports an iCal feed at /calendar.ics. The signed token in the URL is the authentication, so standard calendar applications can subscribe directly — treat the URL itself as a secret.
Register your own iCal feed URL per listing and ElefyMove polls it, reflecting external blocks on the master calendar. The registration endpoint reports polling status and the last error, so a broken feed is visible rather than silent. iCal sync is polled and coarser than the write API — prefer blocks and holds when you can call the API directly.