elefymove
문서

개발자 문서

ElefyMove Open API 가이드와 레퍼런스.

이 가이드는 현재 영어로만 제공됩니다.

Endpoints

메서드엔드포인트스코프설명
POST/api/public/v1/listingslistings:write새 매물을 심사에 제출합니다. 지원하는 9개 언어 중 원하는 언어로 내용을 등록할 수 있습니다.
GET/api/public/v1/listingslistings: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본인 매물을 게시 중단합니다.
POST/api/public/v1/listings/{externalId}/photoslistings:write전체 수정 없이 매물에 사진 한 장을 추가합니다. 이미지는 ElefyMove가 가져와 다시 호스팅하며, 제출한 URL이 그대로 저장되지 않습니다.
DELETE/api/public/v1/listings/{externalId}/photos/{photoId}listings:write매물에서 사진 한 장을 제거합니다. 게시 중인 매물의 사진 수가 최소 개수 미만이 되는 경우 400으로 거부됩니다.

How listings work

  • You identify each listing by your own externalId — ElefyMove never asks you to store its internal ids.
  • Content is multilingual: submit any subset of the 9 supported locales, and ElefyMove serves the right language to each visitor.
  • New and updated listings pass moderation before going live. Subscribe to listing.approved / listing.rejected webhooks instead of polling for status.
  • PATCH is a partial update — any field you omit is left unchanged. DELETE unlists (it does not erase history).
  • Add or remove a single photo without a full PATCH round-trip. A photo you submit as a URL is fetched and re-hosted by ElefyMove — your URL is never stored or linked directly.
  • Removing a photo is refused with a MIN_PHOTOS_REQUIRED 400 if it would drop a currently-published listing below the minimum photo count.
  • Listings sourced through the API link back to their canonical page on elefymove.com.

Reference data

These routes need no scope — any valid key can read them. They expose the exact enum, locale, and currency values POST /listings validates against, and the canonical location hierarchy, so you never have to hard-code or guess them:

메서드엔드포인트스코프설명
GET/api/public/v1/locations유효한 키면 가능도 → 군/구 → 지역 순의 표준 위치 트리를 조회합니다.
GET/api/public/v1/locations/search유효한 키면 가능표준 위치 계층에 대한 자동완성 검색입니다.
GET/api/public/v1/reference/property-types유효한 키면 가능매물이 허용하는 정확한 매물 유형 값 목록입니다.
GET/api/public/v1/reference/amenities유효한 키면 가능편의시설이 지켜야 하는 글자 수 및 개수 제한입니다 — 편의시설은 고정된 목록이 아닌 자유 텍스트입니다.
GET/api/public/v1/reference/locales유효한 키면 가능매물 번역이 허용하는 정확한 로케일 코드 목록입니다.
GET/api/public/v1/reference/currencies유효한 키면 가능매물 가격에 사용되는 통화입니다. ElefyMove는 태국에서만 서비스하므로 항상 THB(태국 바트)입니다.

amenities has no fixed catalog — it is free text validated only by a count and a per-item length limit. GET /reference/amenities returns those limits with an empty values array and freeText: true; do not treat the empty array as "no amenities allowed".