ElefyMoveと連携する
貴社プラットフォームをElefyMoveに接続し、物件情報を掲載し、空室状況をリアルタイムで同期。同じ日付のダブルブッキングはもう起きません。
APIでできること
物件掲載、空室同期、リアルタイム連携を一つの窓口で。
Listings API
多言語対応の物件情報をElefyMoveに送信できます。対応する9言語のうち、任意の言語でコンテンツを送信可能です。すべての掲載は公開前に審査されます。
空室同期
ElefyMoveのマスターカレンダーは、予約可能なすべての情報を集約する唯一の信頼できるデータソースです。各期間には「空室」「一時ホールド中」「予約済み」「ブロック済み」のいずれかの状態が付与され、清掃・引き渡しのバッファ時間も一元管理されるため、どのチャネル経由でもダブルブッキングは発生しません。
一時ホールド
貴社側でのチェックアウト処理中、最長10分間の一時ホールドを設定できます。競合は先着順で解決され、負けたリクエストにはプログラムで判定可能な409レスポンスが返されます。
Webhook
掲載承認・空室変更・ホールドのライフサイクル・予約ステータスなど、HMAC-SHA256で署名されたイベントをほぼリアルタイムで受信できます。ペイロードには日付と参照情報のみが含まれ、ゲストの個人情報は一切含まれません。
iCal同期
各掲載には署名付きのiCalエクスポートURLが用意され、ElefyMoveが貴社のフィードURLをポーリングすることも可能です。連携コードを書くことなく、外部のブロック情報を双方に反映できます。
パートナーができること・できないこと
第一原則:すべての操作は自社データの範囲に限定されます。方向を問わず、パートナー間でのアクセスは一切ありません。
できること
- 自社の物件掲載を作成・更新・掲載取り消しできる(対応する9言語のいずれでも可)
- 自社の掲載内容と審査ステータスを確認できる
- 自社掲載の空室状況を確認し、参照情報付きの外部チャネルブロックを書き込める
- チェックアウト中に一時ホールドを作成・解除できる(最大10分間)
- webhookを登録し、署名付きイベントを受信できる(日付と参照情報のみ)
- 掲載カレンダー(iCal)をエクスポートし、自社のiCalフィードを登録できる
- 公開されている地域階層情報を参照できる
できないこと
- 本APIを通じて支払い、返金、保証金を移動させること
- ElefyMoveの予約や契約を作成すること——外部予約はカレンダーブロックとしてのみ登録されます
- ゲストまたはテナントの個人情報を送受信すること
- 他のパートナーの掲載、ホールド、ブロック、設定にアクセス・変更すること
- ElefyMoveのユーザーにメッセージ送信、連絡、勧誘を行うこと
- 自社が所有しない掲載を読み取り・再公開すること
- レート制限を超過すること、キーを共有すること、アカウント作成を自動化すること
クイックスタート
すべてのリクエストは、発行されたキーを含む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"
}APIリファレンス全体
リクエストとレスポンスのスキーマ、エラー形式、サンプルはすべてインタラクティブな OpenAPI リファレンスに掲載しています。ご自身のキーで各エンドポイントをその場で試せます。
APIドキュメントを開くドキュメント全体を見る全エンドポイント一覧
Open API v1 のすべてのエンドポイントです。リクエストには X-Api-Key ヘッダーでキーを添付し、どのルートも自社のデータだけを対象とします。
ベース URL https://elefymove.com
リスティング
| メソッド | エンドポイント | スコープ | 内容 |
|---|---|---|---|
/api/public/v1/listings | listings:write | 新しいリスティングを審査に提出します。対応する 9 言語のうち任意の言語で内容を登録できます。 | |
| GET | /api/public/v1/listings | listings:read | このキーが保有するリスティングと、その審査ステータスを一覧します。 |
| GET | /api/public/v1/listings/{externalId} | listings:read | 指定した外部 ID で自社のリスティングを 1 件取得します。 |
| PATCH | /api/public/v1/listings/{externalId} | listings:write | 自社のリスティングを更新します。送信しなかった項目は変更されません。 |
| DELETE | /api/public/v1/listings/{externalId} | listings:write | 自社のリスティングを掲載停止にします。 |
空き状況とブロック
| メソッド | エンドポイント | スコープ | 内容 |
|---|---|---|---|
| GET | /api/public/v1/listings/{id}/availability | availability:read | 指定期間のリスティング統合カレンダー（空き・仮押さえ・予約済み・ブロック）を取得します。 |
/api/public/v1/listings/{id}/blocks | availability:write | 外部チャネルのブロックを、自社の参照 ID を付けて作成または更新します。 | |
| DELETE | /api/public/v1/listings/{id}/blocks/{externalRef} | availability:write | 以前に登録した外部チャネルのブロックを削除します。 |
仮押さえ
| メソッド | エンドポイント | スコープ | 内容 |
|---|---|---|---|
/api/public/v1/listings/{id}/holds | holds:write | ゲストが自社サイトで決済する間、期間を仮押さえします。競合に負けたリクエストには SLOT_TAKEN を含む 409 が返ります。 | |
| DELETE | /api/public/v1/holds/{id} | holds:write | 有効期限前に自社の仮押さえを解除します。 |
カレンダー同期（iCal）
| メソッド | エンドポイント | スコープ | 内容 |
|---|---|---|---|
| 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 | リスティングの取得を停止し、登録済みフィードを削除します。 |
Webhook
v1 の Webhook にパートナー側から呼び出すエンドポイントはありません。キーの申請時に受信先 URL をお知らせいただければ、ElefyMove チームが登録し、各配信の署名に使う HMAC-SHA256 シークレットを併せて発行します。配信に失敗した場合は間隔を空けて再送し、ペイロードには日付と参照 ID のみを含みます。
受信できるイベント
listing.approvedlisting.rejectedavailability.changedhold.createdhold.releasedhold.expiredbooking.createdbooking.cancelledping共通
| メソッド | エンドポイント | スコープ | 内容 |
|---|---|---|---|
| GET | /api/public/v1/ping | 有効なキーであれば可 | キーが有効かを確認し、紐づくクライアント名とスコープを取得します。 |
データと公正な利用
- ゲストの個人情報がAPIを通じてやり取りされることはありません。外部のブロック情報には日付と参照情報のみが含まれ、タイの個人データ保護法(PDPA)に準拠しています。
- APIを通じて取り込まれた掲載情報は、必ずelefymove.com上の正規ページにリンクされます。
- キーにはスコープが設定されており、ElefyMoveチームがいつでも失効させることができます。
Open API v1 — 現在、統合パートナーの受け入れを進めています。