ElefyMove Open API 的指南与参考。
这些指南目前仅提供英文版。
| 方法 | 端点 | 权限范围 | 用途 |
|---|---|---|---|
| GET | /api/public/v1/listings/{id}/calendar.ics | 签名 URL，无需密钥 | 以 iCal 订阅源下载房源日历。URL 中的签名令牌即为身份凭证，日历应用可直接订阅。 |
| PUT | /api/public/v1/listings/{id}/ical-sources | availability:write | 注册或替换 ElefyMove 为你的房源轮询的入站 iCal 源。 |
| 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.