Open API v1

ElefyMove와 함께 구축하세요

플랫폼을 ElefyMove에 연결하여 매물을 등록하고, 예약 가능 일정을 실시간으로 동기화하며, 동일 날짜가 이중으로 예약되는 일이 없도록 하세요.

API로 할 수 있는 것

매물 등록, 일정 동기화, 실시간 연동을 하나의 연동 지점에서.

Listings API

다국어 매물 정보를 ElefyMove로 전송할 수 있습니다. 지원하는 9개 언어 중 원하는 언어로 콘텐츠를 제출할 수 있으며, 모든 매물은 게시 전 검수를 거칩니다.

예약 가능 일정 동기화

ElefyMove의 마스터 캘린더는 예약 가능한 모든 항목에 대한 단 하나의 신뢰할 수 있는 데이터 소스입니다. 모든 날짜 범위에는 예약 가능, 임시 홀드, 예약 완료, 차단됨 중 하나의 상태가 표시되며, 청소·인수인계를 위한 버퍼 시간도 중앙에서 일괄 적용되어 어떤 채널을 통하더라도 이중 예약이 발생하지 않습니다.

임시 홀드

게스트가 귀사 측에서 결제를 완료하는 동안 최대 10분간 임시 홀드를 설정할 수 있습니다. 충돌은 선착순으로 해결되며, 밀린 요청에는 프로그램이 처리할 수 있는 409 응답이 반환됩니다.

웹훅

HMAC-SHA256으로 서명된 이벤트—매물 승인, 예약 가능 일정 변경, 홀드 생명주기, 예약 상태—를 거의 실시간으로 구독할 수 있습니다. 페이로드에는 날짜와 참조 정보만 포함되며 게스트 개인정보는 절대 포함되지 않습니다.

iCal 동기화

모든 매물은 서명된 iCal 피드를 내보낼 수 있으며, ElefyMove가 귀사의 피드 URL을 폴링할 수도 있습니다. 별도의 연동 코드를 작성하지 않아도 외부 차단 정보가 양쪽에 동일하게 반영됩니다.

파트너가 할 수 있는 것 — 할 수 없는 것

제1원칙: 모든 작업은 오직 자신의 데이터로만 제한됩니다. 어느 방향으로도 파트너 간 접근은 존재하지 않습니다.

할 수 있는 것

지원되는 9개 언어 중 어느 것으로든 자사 매물을 등록, 수정, 등록 취소할 수 있습니다
자사 매물과 그 심사 상태를 조회할 수 있습니다
자사 매물의 예약 가능 일정을 조회하고, 참조 정보가 포함된 외부 채널 차단을 기록할 수 있습니다
체크아웃 진행 중 최대 10분간 임시 홀드를 생성하고 해제할 수 있습니다
webhook을 등록하고 서명된 이벤트를 수신할 수 있습니다(날짜와 참조 정보만 포함)
매물 캘린더(iCal)를 내보내고, 자사의 iCal 피드를 등록할 수 있습니다
공개된 지역 계층 정보를 조회할 수 있습니다

할 수 없는 것

본 API를 통해 결제, 환불, 보증금을 이동시키는 것
ElefyMove 예약이나 계약을 생성하는 것 — 외부 예약은 캘린더 차단 형태로만 등록됩니다
게스트 또는 세입자의 개인정보를 송수신하는 것
다른 파트너의 매물, 홀드, 차단, 설정에 접근하거나 수정하는 것
ElefyMove 사용자에게 메시지를 보내거나 연락, 권유하는 것
소유하지 않은 매물을 조회하거나 재게시하는 것
요청 제한을 초과하거나, 키를 공유하거나, 계정 생성을 자동화하는 것

API 이용약관 전문 보기

액세스 신청

개발자 계정을 만들고 이메일을 인증하면 대시보드에서 직접 API 키를 발급할 수 있습니다. 실제 매물을 게시하려면 ElefyMove 팀이 키를 인증된 임대인 계정에 연결해야 합니다.

API 키 만들기

계정을 만들면 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/listings`	`listings:write`	새 매물을 심사에 제출합니다. 지원하는 9개 언어 중 원하는 언어로 내용을 등록할 수 있습니다.
GET	`/api/public/v1/listings`	`listings:read`	해당 키가 보유한 매물과 현재 심사 상태를 모두 조회합니다.
GET	`/api/public/v1/listings/{externalId}`	`listings:read`	직접 지정한 외부 ID로 본인 매물 하나를 조회합니다.
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`	지정한 기간의 통합 캘린더를 조회합니다 — 예약 가능, 홀드, 예약 완료, 차단.
POST	`/api/public/v1/listings/{id}/blocks`	`availability:write`	외부 채널 차단을 본인 참조 번호와 함께 생성하거나 수정합니다.
DELETE	`/api/public/v1/listings/{id}/blocks/{externalRef}`	`availability:write`	이전에 등록한 외부 채널 차단을 삭제합니다.

임시 홀드

메서드	엔드포인트	스코프	설명
POST	`/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`	가져오기를 중단하고 매물에 등록된 피드를 삭제합니다.

웹훅

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 — 현재 연동 파트너를 순차적으로 온보딩하고 있습니다.