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.