House API
1. 빈집 게시글 작성하기
빈집 게시글 작성 시, tmpYn 플래그를 통해 임시저장 여부를 판단합니다.
RecommendedTag 값에는 아래 표를 참고해서 Enum 명을 보내주셔야 합니다.
| Enum 명 | 한글 명 |
|---|---|
WANT_TO_INTERIOR_FOR_THE_FIRST_TIME |
처음부터 인테리어 하고 싶어요. |
WANT_TO_READY_HOUSE |
어느 정도 준비된 집이 좋아요. |
HAVE_CHILDREN |
아이와 함께 살아요. |
WANT_TO_LOOK_A_GOOD_VIEW |
경치가 좋은 집을 원해요. |
WANT_TO_FARM |
농사 짓기를 원해요. |
(23.09.29 업데이트) ‼️게시글 임시저장/저장에 관해 수정된 사항들입니다. ‼️️
-
임시저장인 경우
유효성 검사를 진행하지 않습니다. null 혹은 blank로 보내는 데이터에 대해 서버 측에서 "" 로 디비에 저장 후, 실제 저장할 때 값을 update 합니다.
-
저장인 경우
유효성 검사를 진행합니다. 만약 필수값이 누락되면, 400 에러코드와 함께 어떤 필드가 누락된 것인지 안내 메세지를 반환합니다.
작성자가 공인중개사/관리자 인 경우, 바로 조회 가능한 상태로 등록합니다.
일반 사용자의 경우, 관리자의 승인이 필요하기에 바로 조회는 안됩니다.
( 여기서 바로 조회는 /{houseId} 로 요청을 보내는 것을 의미합니다. )
게시글 데이터 중, 추천 태그는 필수값이 아닌 것으로 변경하였습니다. null 혹은 [] 빈 리스트로 보내도 상관없습니다.
Request
POST /api/v1/houses HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NjAsImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.Ju3FI9kFmShx0rT0RBzbeOCJpcgDDZtGmdZwXID9qziThNkupa-M6tEg1ePUKPMe7T7o_UV4F-lR2S8JeqqPHg
Accept: application/json
Content-Length: 753
Host: localhost:8080
{
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"detail" : "1동 103호",
"zipCode" : "12345",
"size" : "120909000",
"purpose" : "주거용 ( 방3, 화장실 2 )",
"floorNum" : 2,
"contact" : "070-1234-5678",
"createdDate" : "1990",
"price" : 12000,
"monthlyPrice" : 0.0,
"agentName" : "행복부동산",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"code" : "<body> <div> <h2>행복부동산 최신 매물로</h2> </div> <div> <i>주거용 주택</i>을 소개합니다. </div> </body>",
"imageUrls" : [ "img-001", "img-002", "img-002", "img-002", "img-002" ],
"tmpYn" : false,
"recommendedTag" : [ "WANT_TO_INTERIOR_FOR_THE_FIRST_TIME" ]
}Request fields
| Path | Type | Description |
|---|---|---|
|
|
매매 타입 ( SALE(매매), JEONSE(전세), MONTHLYRENT(월세) )은 필수값입니다. |
|
|
주소는 '시도’로 시작하되, 줄이지 않은 표현으로 작성해야 합니다. 예: 서울시 서대문구 거북골로 34 |
|
|
상세 주소 예: 1동 1호 |
|
|
우편번호 ( string 형식입니다. ) |
|
|
집 크기는 m^2 단위로 산정해서 작성해야 합니다. string 형식입니다. |
|
|
매물 목적/용도 예: 거주 ( 방3, 화장실 2 ) |
|
|
매물이 위치한 층수 ( 단독주택인 경우, null 로 전달 시 서버에서 0으로 세팅 ) |
|
|
연락 가능한 연락처를 01000000000 형식으로 작성 |
|
|
준공연도는 숫자만 입력해주세요. YYYY 형태로 서버에서 관리합니다. |
|
|
매물가격은 만원 단위로 산정해서 작성해주세요. ( 월세의 경우, 보증금을 작성해주세요. ) |
|
|
월세 가격은 만원 단위로 산정해서 소수점 포함으로 작성해주세요. Double 형식으로 관리합니다. |
|
|
공인중개사명을 작성해주세요. ( 없는 경우, 서버에서 null로 관리합니다. ) |
|
|
빈집 게시글의 제목을 입력해주세요. |
|
|
빈집 게시글의 내용을 입력해주세요. |
|
|
이미지 주소를 string 배열 형식으로 입력해주세요. |
|
|
임시저장 여부를 입력해주세요. (임시저장 : true, 저장: false) |
|
|
추천태그를 입력해주세요.( 없는 경우, 빈 문자열 리스트로 보내주세요. ) |
Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 65
{
"code" : "SUCCESS",
"message" : "성공",
"data" : 4053
}Response fields
| Path | Type | Description |
|---|---|---|
|
|
결과 코드 |
|
|
응답 메세지 |
|
|
빈집 게시글 아이디 |
1-2. 빈집 게시글 유효성 검사
빈집 게시글 작성 시, 게시글의 내용이 10,000자를 넘기는 지 확인하는 유효성 검사에 대한 내용입니다.
Request
POST /api/v1/houses HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NjEsImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.xuCnVr2sXQCzCUunE1tHXvgDjKi_NxaXbsWY5aXNv2ThqOG6zp8quQXpoZw2u224s-o55U4dZyzECJnMut9LDA
Accept: application/json
Content-Length: 26047
Host: localhost:8080
{
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"detail" : "1동 103호",
"zipCode" : "12345",
"size" : "120909000",
"purpose" : "주거용 ( 방3, 화장실 2 )",
"floorNum" : 2,
"contact" : "070-1234-5678",
"createdDate" : "1990",
"price" : 12000,
"monthlyPrice" : 0.0,
"agentName" : "행복부동산",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"code" : "<body> <div> <h2>글자수가 10,000자를 넘어서는지 테스트해보기 위한 글입니다. 행복부동산 최신 매물입니다.</h2> </div> <div> 오도이촌, 세컨하우스를 꿈꾸고 있는 여러분, 오도이촌으로 어떤 지역을 꿈꾸고 계시나요?\n오도이촌을 위해 세컨하우스를 택할 지역을 고를 때 가장 중요한 기준으로는 ‘편리한 교통’, ‘수려한 자연환경’, ‘뛰어난 편의시설’ 등이 있는데요.\n이번 컨텐츠에서는 어떤 지역이 여러분의 세컨하우스 기준을 충족하는 지역일지 제시해 드리고자 합니다.\n경기도\n도심과 가까운 지역, 양평\n양평은 도심과 가깝고 교통이 좋아 오도이촌으로 특히 인기가 많은 지역입니다.\n1) 용이한 교통\n양평은 서울에서 차로 약 50분 거리에 위치해있는데요. 경의중앙선 용문역, 6번 국도 등 교통 인프라가 잘 갖추어져 있습니다. 인근에는 서울 송파~양평 고속도로 개통(2023년 예정)도 앞두고 있어 교통환경이 더욱 개선될 전망입니다.\n2) 관광지/자연환경\n양평은 용문 5일장, 용문사, 중원계곡, 용문 관광단지 등으로도 유명합니다. 볼거리와 먹을거리, 놀거리가 많고 레저활동을 하기 좋은 여건을 갖추고 있습니다. 또한 용문산과 북한강이 어우러진 입지로, 하늘과 숲과 물이 하나가 되는 자연환경을 누릴 수 있습니다.\n3) 문화시설/편의시설\n자연경관과 공기가 좋은 곳 뿐만 아니라 문화시설/편의시설이 있는 곳도 중요합니다. 시골은 특히나 대형마트가 부족한데 양평은 비교적 대형마트와 생활 편의시설이 많은 곳에 속합니다.\n세컨하우스를 찾는 사람들의 양평 대표 지역은 서종면, 옥천면, 용문면, 강하면이 대표적입니다. 양평 중에서도 문화공간이 가까이 있는 곳은 ‘서종면’ 쪽입니다.\n양평과 비슷한 지역으로는 경기도 광주, 가평 등이 있습니다. 매경이코노미가 부동산 전문가, 금융권 프라이빗 뱅커(PB) 30인을 대상으로 설문조사한 결과 세컨드하우스를 마련하기 좋은 곳 1위로 ‘경기도 양평’이 꼽혔다. 복수응답 기준으로 총 20표를 얻었습니다. 이어 2위는 ‘가평(12표)’, 3위는 ‘남양주(7표)’로 경기도 소재 시군이 1~3위를 휩쓸었다고 합니다.\n강원도\n비과세 혜택\n부동산 업계에 따르면 규제의 사각지대에 있고 교통여건의 개선으로 수도권과 접근성이 좋은 강원도의 장점이 외지인들의 세컨하우스 투자로 이어지면서, 매도자 우위 시장이 유지되고 있다고 합니다. 강원도 내 18개 시, 군, 구는 모두 비규제지역으로, LTV(주택담보대출비율)이 무주택자 기준 최대 70%까지 적용되어 타운하우스나 아파트를 마련하기가 상대적으로 유리합니다.\n강원도는 바다, 강, 산, 뷰, 관광지 등 휴가를 누리기에 최적인 지역인데 최근 고속도로와 KTX, 관광지 개발 사업 등의 영향으로 향후 시세차익을 기대하는 투자자들까지 몰려 세컨하우스의 가치가 높아지고 있다고 합니다.\n철도호재\n삼척~동해~강릉 구간 ‘동해선’과 동해 신항~삼척해변 구간 ‘동해신항선’, 용문-흥천 간 철도, 원주-만종 간 철도 등 강원 지역 신규 사업으로 반영되었습니다.\n세컨하우스 매물이 많은 속초, 강릉\n국내 대표 관광지인 속초는 2018년 평창올림픽 개최를 계기로 2017년 서울~양양고속도로 전 구간이 개통하면서 서울 접근성이 우수한 관광지역으로 떠오른 지역입니다.\n1) 관광 유입\n특히 최근에는 국내에서 유일하게 해변에 위치한 대관람차 ‘속초아이’가 오픈해 관광명소로서의 입지를 굳건히 하고 있습니다.\n2) 교통 개선\n속초는 동해북부선, 동서고속화철도 등 교통호재도 이어지고 있는데요. 서울~순천~속초를 잇는 동서고속화철도의 경우 2027년 개통을 앞두고 있습니다. KTX 속초역 개통과 동시에 향후 서울에서 속초까지 약 1시간대에 이동이 가능해질 전망입니다. 더불어 강릉선 KTX 이용객까지 더할 수 있어, 동해안 관광 유입도 기대할 수 있습니다.\n해외\n세컨하우스로 꼭 국내로만 고집할 필요는 없는데요. 멀지 않은 중국, 일본, 동남아 지역은 주말여행으로 충분히 다녀올 수 있기 때문입니다. 외국에서는 필리핀 세부&마닐라, 말레이시아 조호르바루 등이 꼽혔습니다.\n정말 다양한 지역이 있는데요. 이번 주말에는 자신에게 맞는 지역을 한 번 비교해 보며 찾아보는 것은 어떨까요?오도이촌, 세컨하우스를 꿈꾸고 있는 여러분, 오도이촌으로 어떤 지역을 꿈꾸고 계시나요?\n오도이촌을 위해 세컨하우스를 택할 지역을 고를 때 가장 중요한 기준으로는 ‘편리한 교통’, ‘수려한 자연환경’, ‘뛰어난 편의시설’ 등이 있는데요.\n이번 컨텐츠에서는 어떤 지역이 여러분의 세컨하우스 기준을 충족하는 지역일지 제시해 드리고자 합니다.\n경기도\n도심과 가까운 지역, 양평\n양평은 도심과 가깝고 교통이 좋아 오도이촌으로 특히 인기가 많은 지역입니다.\n1) 용이한 교통\n양평은 서울에서 차로 약 50분 거리에 위치해있는데요. 경의중앙선 용문역, 6번 국도 등 교통 인프라가 잘 갖추어져 있습니다. 인근에는 서울 송파~양평 고속도로 개통(2023년 예정)도 앞두고 있어 교통환경이 더욱 개선될 전망입니다.\n2) 관광지/자연환경\n양평은 용문 5일장, 용문사, 중원계곡, 용문 관광단지 등으로도 유명합니다. 볼거리와 먹을거리, 놀거리가 많고 레저활동을 하기 좋은 여건을 갖추고 있습니다. 또한 용문산과 북한강이 어우러진 입지로, 하늘과 숲과 물이 하나가 되는 자연환경을 누릴 수 있습니다.\n3) 문화시설/편의시설\n자연경관과 공기가 좋은 곳 뿐만 아니라 문화시설/편의시설이 있는 곳도 중요합니다. 시골은 특히나 대형마트가 부족한데 양평은 비교적 대형마트와 생활 편의시설이 많은 곳에 속합니다.\n세컨하우스를 찾는 사람들의 양평 대표 지역은 서종면, 옥천면, 용문면, 강하면이 대표적입니다. 양평 중에서도 문화공간이 가까이 있는 곳은 ‘서종면’ 쪽입니다.\n양평과 비슷한 지역으로는 경기도 광주, 가평 등이 있습니다. 매경이코노미가 부동산 전문가, 금융권 프라이빗 뱅커(PB) 30인을 대상으로 설문조사한 결과 세컨드하우스를 마련하기 좋은 곳 1위로 ‘경기도 양평’이 꼽혔다. 복수응답 기준으로 총 20표를 얻었습니다. 이어 2위는 ‘가평(12표)’, 3위는 ‘남양주(7표)’로 경기도 소재 시군이 1~3위를 휩쓸었다고 합니다.\n강원도\n비과세 혜택\n부동산 업계에 따르면 규제의 사각지대에 있고 교통여건의 개선으로 수도권과 접근성이 좋은 강원도의 장점이 외지인들의 세컨하우스 투자로 이어지면서, 매도자 우위 시장이 유지되고 있다고 합니다. 강원도 내 18개 시, 군, 구는 모두 비규제지역으로, LTV(주택담보대출비율)이 무주택자 기준 최대 70%까지 적용되어 타운하우스나 아파트를 마련하기가 상대적으로 유리합니다.\n강원도는 바다, 강, 산, 뷰, 관광지 등 휴가를 누리기에 최적인 지역인데 최근 고속도로와 KTX, 관광지 개발 사업 등의 영향으로 향후 시세차익을 기대하는 투자자들까지 몰려 세컨하우스의 가치가 높아지고 있다고 합니다.\n철도호재\n삼척~동해~강릉 구간 ‘동해선’과 동해 신항~삼척해변 구간 ‘동해신항선’, 용문-흥천 간 철도, 원주-만종 간 철도 등 강원 지역 신규 사업으로 반영되었습니다.\n세컨하우스 매물이 많은 속초, 강릉\n국내 대표 관광지인 속초는 2018년 평창올림픽 개최를 계기로 2017년 서울~양양고속도로 전 구간이 개통하면서 서울 접근성이 우수한 관광지역으로 떠오른 지역입니다.\n1) 관광 유입\n특히 최근에는 국내에서 유일하게 해변에 위치한 대관람차 ‘속초아이’가 오픈해 관광명소로서의 입지를 굳건히 하고 있습니다.\n2) 교통 개선\n속초는 동해북부선, 동서고속화철도 등 교통호재도 이어지고 있는데요. 서울~순천~속초를 잇는 동서고속화철도의 경우 2027년 개통을 앞두고 있습니다. KTX 속초역 개통과 동시에 향후 서울에서 속초까지 약 1시간대에 이동이 가능해질 전망입니다. 더불어 강릉선 KTX 이용객까지 더할 수 있어, 동해안 관광 유입도 기대할 수 있습니다.\n해외\n세컨하우스로 꼭 국내로만 고집할 필요는 없는데요. 멀지 않은 중국, 일본, 동남아 지역은 주말여행으로 충분히 다녀올 수 있기 때문입니다. 외국에서는 필리핀 세부&마닐라, 말레이시아 조호르바루 등이 꼽혔습니다.\n정말 다양한 지역이 있는데요. 이번 주말에는 자신에게 맞는 지역을 한 번 비교해 보며 찾아보는 것은 어떨까요?오도이촌, 세컨하우스를 꿈꾸고 있는 여러분, 오도이촌으로 어떤 지역을 꿈꾸고 계시나요?\n오도이촌을 위해 세컨하우스를 택할 지역을 고를 때 가장 중요한 기준으로는 ‘편리한 교통’, ‘수려한 자연환경’, ‘뛰어난 편의시설’ 등이 있는데요.\n이번 컨텐츠에서는 어떤 지역이 여러분의 세컨하우스 기준을 충족하는 지역일지 제시해 드리고자 합니다.\n경기도\n도심과 가까운 지역, 양평\n양평은 도심과 가깝고 교통이 좋아 오도이촌으로 특히 인기가 많은 지역입니다.\n1) 용이한 교통\n양평은 서울에서 차로 약 50분 거리에 위치해있는데요. 경의중앙선 용문역, 6번 국도 등 교통 인프라가 잘 갖추어져 있습니다. 인근에는 서울 송파~양평 고속도로 개통(2023년 예정)도 앞두고 있어 교통환경이 더욱 개선될 전망입니다.\n2) 관광지/자연환경\n양평은 용문 5일장, 용문사, 중원계곡, 용문 관광단지 등으로도 유명합니다. 볼거리와 먹을거리, 놀거리가 많고 레저활동을 하기 좋은 여건을 갖추고 있습니다. 또한 용문산과 북한강이 어우러진 입지로, 하늘과 숲과 물이 하나가 되는 자연환경을 누릴 수 있습니다.\n3) 문화시설/편의시설\n자연경관과 공기가 좋은 곳 뿐만 아니라 문화시설/편의시설이 있는 곳도 중요합니다. 시골은 특히나 대형마트가 부족한데 양평은 비교적 대형마트와 생활 편의시설이 많은 곳에 속합니다.\n세컨하우스를 찾는 사람들의 양평 대표 지역은 서종면, 옥천면, 용문면, 강하면이 대표적입니다. 양평 중에서도 문화공간이 가까이 있는 곳은 ‘서종면’ 쪽입니다.\n양평과 비슷한 지역으로는 경기도 광주, 가평 등이 있습니다. 매경이코노미가 부동산 전문가, 금융권 프라이빗 뱅커(PB) 30인을 대상으로 설문조사한 결과 세컨드하우스를 마련하기 좋은 곳 1위로 ‘경기도 양평’이 꼽혔다. 복수응답 기준으로 총 20표를 얻었습니다. 이어 2위는 ‘가평(12표)’, 3위는 ‘남양주(7표)’로 경기도 소재 시군이 1~3위를 휩쓸었다고 합니다.\n강원도\n비과세 혜택\n부동산 업계에 따르면 규제의 사각지대에 있고 교통여건의 개선으로 수도권과 접근성이 좋은 강원도의 장점이 외지인들의 세컨하우스 투자로 이어지면서, 매도자 우위 시장이 유지되고 있다고 합니다. 강원도 내 18개 시, 군, 구는 모두 비규제지역으로, LTV(주택담보대출비율)이 무주택자 기준 최대 70%까지 적용되어 타운하우스나 아파트를 마련하기가 상대적으로 유리합니다.\n강원도는 바다, 강, 산, 뷰, 관광지 등 휴가를 누리기에 최적인 지역인데 최근 고속도로와 KTX, 관광지 개발 사업 등의 영향으로 향후 시세차익을 기대하는 투자자들까지 몰려 세컨하우스의 가치가 높아지고 있다고 합니다.\n철도호재\n삼척~동해~강릉 구간 ‘동해선’과 동해 신항~삼척해변 구간 ‘동해신항선’, 용문-흥천 간 철도, 원주-만종 간 철도 등 강원 지역 신규 사업으로 반영되었습니다.\n세컨하우스 매물이 많은 속초, 강릉\n국내 대표 관광지인 속초는 2018년 평창올림픽 개최를 계기로 2017년 서울~양양고속도로 전 구간이 개통하면서 서울 접근성이 우수한 관광지역으로 떠오른 지역입니다.\n1) 관광 유입\n특히 최근에는 국내에서 유일하게 해변에 위치한 대관람차 ‘속초아이’가 오픈해 관광명소로서의 입지를 굳건히 하고 있습니다.\n2) 교통 개선\n속초는 동해북부선, 동서고속화철도 등 교통호재도 이어지고 있는데요. 서울~순천~속초를 잇는 동서고속화철도의 경우 2027년 개통을 앞두고 있습니다. KTX 속초역 개통과 동시에 향후 서울에서 속초까지 약 1시간대에 이동이 가능해질 전망입니다. 더불어 강릉선 KTX 이용객까지 더할 수 있어, 동해안 관광 유입도 기대할 수 있습니다.\n해외\n세컨하우스로 꼭 국내로만 고집할 필요는 없는데요. 멀지 않은 중국, 일본, 동남아 지역은 주말여행으로 충분히 다녀올 수 있기 때문입니다. 외국에서는 필리핀 세부&마닐라, 말레이시아 조호르바루 등이 꼽혔습니다.\n정말 다양한 지역이 있는데요. 이번 주말에는 자신에게 맞는 지역을 한 번 비교해 보며 찾아보는 것은 어떨까요?오도이촌, 세컨하우스를 꿈꾸고 있는 여러분, 오도이촌으로 어떤 지역을 꿈꾸고 계시나요?\n오도이촌을 위해 세컨하우스를 택할 지역을 고를 때 가장 중요한 기준으로는 ‘편리한 교통’, ‘수려한 자연환경’, ‘뛰어난 편의시설’ 등이 있는데요.\n이번 컨텐츠에서는 어떤 지역이 여러분의 세컨하우스 기준을 충족하는 지역일지 제시해 드리고자 합니다.\n경기도\n도심과 가까운 지역, 양평\n양평은 도심과 가깝고 교통이 좋아 오도이촌으로 특히 인기가 많은 지역입니다.\n1) 용이한 교통\n양평은 서울에서 차로 약 50분 거리에 위치해있는데요. 경의중앙선 용문역, 6번 국도 등 교통 인프라가 잘 갖추어져 있습니다. 인근에는 서울 송파~양평 고속도로 개통(2023년 예정)도 앞두고 있어 교통환경이 더욱 개선될 전망입니다.\n2) 관광지/자연환경\n양평은 용문 5일장, 용문사, 중원계곡, 용문 관광단지 등으로도 유명합니다. 볼거리와 먹을거리, 놀거리가 많고 레저활동을 하기 좋은 여건을 갖추고 있습니다. 또한 용문산과 북한강이 어우러진 입지로, 하늘과 숲과 물이 하나가 되는 자연환경을 누릴 수 있습니다.\n3) 문화시설/편의시설\n자연경관과 공기가 좋은 곳 뿐만 아니라 문화시설/편의시설이 있는 곳도 중요합니다. 시골은 특히나 대형마트가 부족한데 양평은 비교적 대형마트와 생활 편의시설이 많은 곳에 속합니다.\n세컨하우스를 찾는 사람들의 양평 대표 지역은 서종면, 옥천면, 용문면, 강하면이 대표적입니다. 양평 중에서도 문화공간이 가까이 있는 곳은 ‘서종면’ 쪽입니다.\n양평과 비슷한 지역으로는 경기도 광주, 가평 등이 있습니다. 매경이코노미가 부동산 전문가, 금융권 프라이빗 뱅커(PB) 30인을 대상으로 설문조사한 결과 세컨드하우스를 마련하기 좋은 곳 1위로 ‘경기도 양평’이 꼽혔다. 복수응답 기준으로 총 20표를 얻었습니다. 이어 2위는 ‘가평(12표)’, 3위는 ‘남양주(7표)’로 경기도 소재 시군이 1~3위를 휩쓸었다고 합니다.\n강원도\n비과세 혜택\n부동산 업계에 따르면 규제의 사각지대에 있고 교통여건의 개선으로 수도권과 접근성이 좋은 강원도의 장점이 외지인들의 세컨하우스 투자로 이어지면서, 매도자 우위 시장이 유지되고 있다고 합니다. 강원도 내 18개 시, 군, 구는 모두 비규제지역으로, LTV(주택담보대출비율)이 무주택자 기준 최대 70%까지 적용되어 타운하우스나 아파트를 마련하기가 상대적으로 유리합니다.\n강원도는 바다, 강, 산, 뷰, 관광지 등 휴가를 누리기에 최적인 지역인데 최근 고속도로와 KTX, 관광지 개발 사업 등의 영향으로 향후 시세차익을 기대하는 투자자들까지 몰려 세컨하우스의 가치가 높아지고 있다고 합니다.\n철도호재\n삼척~동해~강릉 구간 ‘동해선’과 동해 신항~삼척해변 구간 ‘동해신항선’, 용문-흥천 간 철도, 원주-만종 간 철도 등 강원 지역 신규 사업으로 반영되었습니다.\n세컨하우스 매물이 많은 속초, 강릉\n국내 대표 관광지인 속초는 2018년 평창올림픽 개최를 계기로 2017년 서울~양양고속도로 전 구간이 개통하면서 서울 접근성이 우수한 관광지역으로 떠오른 지역입니다.\n1) 관광 유입\n특히 최근에는 국내에서 유일하게 해변에 위치한 대관람차 ‘속초아이’가 오픈해 관광명소로서의 입지를 굳건히 하고 있습니다.\n2) 교통 개선\n속초는 동해북부선, 동서고속화철도 등 교통호재도 이어지고 있는데요. 서울~순천~속초를 잇는 동서고속화철도의 경우 2027년 개통을 앞두고 있습니다. KTX 속초역 개통과 동시에 향후 서울에서 속초까지 약 1시간대에 이동이 가능해질 전망입니다. 더불어 강릉선 KTX 이용객까지 더할 수 있어, 동해안 관광 유입도 기대할 수 있습니다.\n해외\n세컨하우스로 꼭 국내로만 고집할 필요는 없는데요. 멀지 않은 중국, 일본, 동남아 지역은 주말여행으로 충분히 다녀올 수 있기 때문입니다. 외국에서는 필리핀 세부&마닐라, 말레이시아 조호르바루 등이 꼽혔습니다.\n정말 다양한 지역이 있는데요. 이번 주말에는 자신에게 맞는 지역을 한 번 비교해 보며 찾아보는 것은 어떨까요?오도이촌, 세컨하우스를 꿈꾸고 있는 여러분, 오도이촌으로 어떤 지역을 꿈꾸고 계시나요?\n오도이촌을 위해 세컨하우스를 택할 지역을 고를 때 가장 중요한 기준으로는 ‘편리한 교통’, ‘수려한 자연환경’, ‘뛰어난 편의시설’ 등이 있는데요.\n이번 컨텐츠에서는 어떤 지역이 여러분의 세컨하우스 기준을 충족하는 지역일지 제시해 드리고자 합니다.\n경기도\n도심과 가까운 지역, 양평\n양평은 도심과 가깝고 교통이 좋아 오도이촌으로 특히 인기가 많은 지역입니다.\n1) 용이한 교통\n양평은 서울에서 차로 약 50분 거리에 위치해있는데요. 경의중앙선 용문역, 6번 국도 등 교통 인프라가 잘 갖추어져 있습니다. 인근에는 서울 송파~양평 고속도로 개통(2023년 예정)도 앞두고 있어 교통환경이 더욱 개선될 전망입니다.\n2) 관광지/자연환경\n양평은 용문 5일장, 용문사, 중원계곡, 용문 관광단지 등으로도 유명합니다. 볼거리와 먹을거리, 놀거리가 많고 레저활동을 하기 좋은 여건을 갖추고 있습니다. 또한 용문산과 북한강이 어우러진 입지로, 하늘과 숲과 물이 하나가 되는 자연환경을 누릴 수 있습니다.\n3) 문화시설/편의시설\n자연경관과 공기가 좋은 곳 뿐만 아니라 문화시설/편의시설이 있는 곳도 중요합니다. 시골은 특히나 대형마트가 부족한데 양평은 비교적 대형마트와 생활 편의시설이 많은 곳에 속합니다.\n세컨하우스를 찾는 사람들의 양평 대표 지역은 서종면, 옥천면, 용문면, 강하면이 대표적입니다. 양평 중에서도 문화공간이 가까이 있는 곳은 ‘서종면’ 쪽입니다.\n양평과 비슷한 지역으로는 경기도 광주, 가평 등이 있습니다. 매경이코노미가 부동산 전문가, 금융권 프라이빗 뱅커(PB) 30인을 대상으로 설문조사한 결과 세컨드하우스를 마련하기 좋은 곳 1위로 ‘경기도 양평’이 꼽혔다. 복수응답 기준으로 총 20표를 얻었습니다. 이어 2위는 ‘가평(12표)’, 3위는 ‘남양주(7표)’로 경기도 소재 시군이 1~3위를 휩쓸었다고 합니다.\n강원도\n비과세 혜택\n부동산 업계에 따르면 규제의 사각지대에 있고 교통여건의 개선으로 수도권과 접근성이 좋은 강원도의 장점이 외지인들의 세컨하우스 투자로 이어지면서, 매도자 우위 시장이 유지되고 있다고 합니다. 강원도 내 18개 시, 군, 구는 모두 비규제지역으로, LTV(주택담보대출비율)이 무주택자 기준 최대 70%까지 적용되어 타운하우스나 아파트를 마련하기가 상대적으로 유리합니다.\n강원도는 바다, 강, 산, 뷰, 관광지 등 휴가를 누리기에 최적인 지역인데 최근 고속도로와 KTX, 관광지 개발 사업 등의 영향으로 향후 시세차익을 기대하는 투자자들까지 몰려 세컨하우스의 가치가 높아지고 있다고 합니다.\n철도호재\n삼척~동해~강릉 구간 ‘동해선’과 동해 신항~삼척해변 구간 ‘동해신항선’, 용문-흥천 간 철도, 원주-만종 간 철도 등 강원 지역 신규 사업으로 반영되었습니다.\n세컨하우스 매물이 많은 속초, 강릉\n국내 대표 관광지인 속초는 2018년 평창올림픽 개최를 계기로 2017년 서울~양양고속도로 전 구간이 개통하면서 서울 접근성이 우수한 관광지역으로 떠오른 지역입니다.\n1) 관광 유입\n특히 최근에는 국내에서 유일하게 해변에 위치한 대관람차 ‘속초아이’가 오픈해 관광명소로서의 입지를 굳건히 하고 있습니다.\n2) 교통 개선\n속초는 동해북부선, 동서고속화철도 등 교통호재도 이어지고 있는데요. 서울~순천~속초를 잇는 동서고속화철도의 경우 2027년 개통을 앞두고 있습니다. KTX 속초역 개통과 동시에 향후 서울에서 속초까지 약 1시간대에 이동이 가능해질 전망입니다. 더불어 강릉선 KTX 이용객까지 더할 수 있어, 동해안 관광 유입도 기대할 수 있습니다.\n해외\n철도호재\n삼척~동해~강릉 구간 ‘동해선’과 동해 신항~삼척해변 구간 ‘동해신항선’, 용문-흥천 간 철도, 원주-만종 간 철도 등 강원 지역 신규 사업으로 반영되었습니다.\n세컨하우스 매물이 많은 속초, 강릉\n국내 대표 관광지인 속초는 2018년 평창올림픽 개최를 계기로 2017년 서울~양양고속도로 전 구간이 개통하면서 서울 접근성이 우수한 관광지역으로 떠오른 지역입니다.\n1) 관광 유입\n특히 최근에는 국내에서 유일하게 해변에 위치한 대관람차 ‘속초아이’가 오픈해 관광명소로서의 입지를 굳건히 하고 있습니다.\n2) 교통 개선\n속초는 동해북부선, 동서고속화철도 등 교통호재도 이어지고 있는데요. 서울~순천~속초를 잇는 동서고속화철도의 경우 2027년 개통을 앞두고 있습니다. KTX 속초역 개통과 동시에 향후 서울에서 속초까지 약 1시간대에 이동이 가능해질 전망입니다. 더불어 강릉선 KTX 이용객까지 더할 수 있어, 동해안 관광 유입도 기대할 수 있습니다.\n해외\n세컨하우스로 꼭 국내로만 고집할 필요는 없는데요. 멀지 않은 중국, 일본, 동남아 지역은 주말여행으로 충분히 다녀올 수 있기 때문입니다. 외국에서는 필리핀 세부&마닐라, 말레이시아 조호르바루 등이 꼽혔습니다.\n정말 다양한 지역이 있는데요. 이번 주말에는 자신에게 맞는 지역을 한 번 비교해 보며 찾아보는 것은 어떨까요?세컨하우스로 꼭 국내로만 고집할 필요는 없는데요. 멀지 않은 중국, 일본, 동남아 지역은 주말여행으로 충분히 다녀올 수 있기 때문입니다. 외국에서는 필리핀 세부&마닐라, 말레이시아 조호르바루 등이 꼽혔습니다.\n정말 다양한 지역이 있는데요. 이번 주말에는 자신에게 맞는 지역을 한 번 비교해 보며 찾아보는 것은 어떨까요? </div> </body>",
"imageUrls" : [ "img-001", "img-002" ],
"tmpYn" : false,
"recommendedTag" : [ ]
}Request Fields
| Path | Type | Description |
|---|---|---|
|
|
매매 타입 ( SALE(매매), JEONSE(전세), MONTHLYRENT(월세) )은 필수값입니다. |
|
|
주소는 '시도’로 시작하되, 줄이지 않은 표현으로 작성해야 합니다. 예: 서울시 서대문구 거북골로 34 |
|
|
상세 주소 예: 1동 1호 |
|
|
우편번호 ( string 형식입니다. ) |
|
|
집 크기는 m^2 단위로 산정해서 작성해야 합니다. string 형식입니다. |
|
|
매물 목적/용도 예: 거주 ( 방3, 화장실 2 ) |
|
|
매물이 위치한 층수 ( 단독주택인 경우, null 로 전달 시 서버에서 0으로 세팅 ) |
|
|
연락 가능한 연락처를 01000000000 형식으로 작성 |
|
|
준공연도는 숫자만 입력해주세요. YYYY 형태로 서버에서 관리합니다. |
|
|
매물가격은 만원 단위로 산정해서 작성해주세요. ( 월세의 경우, 보증금을 작성해주세요. ) |
|
|
월세 가격은 만원 단위로 산정해서 소수점 포함으로 작성해주세요. Double 형식으로 관리합니다. |
|
|
공인중개사명을 작성해주세요. ( 없는 경우, 서버에서 null로 관리합니다. ) |
|
|
빈집 게시글의 제목을 입력해주세요. |
|
|
빈집 게시글의 내용을 입력해주세요. |
|
|
이미지 주소를 string 배열 형식으로 입력해주세요. |
|
|
임시저장 여부를 입력해주세요. (임시저장 : true, 저장: false) |
|
|
추천태그를 입력해주세요.( 없는 경우, 빈 문자열 리스트로 보내주세요. ) |
Response
HTTP/1.1 400 Bad Request
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 98
{
"code" : "H0000",
"message" : "빈집 게시글의 내용이 10000자를 넘었습니다."
}2. 빈집 게시글 수정하기
임시저장 상태 혹은 저장 상태의 게시글을 수정할 수 있습니다.
임시저장에서 저장으로 상태 변경을 원하는 경우, tmpYn 값을 false로 변경해주셔야 합니다.
게시글 수정 시, 작성자 본인만 수정 가능합니다.
Request
PUT /api/v1/houses/4030 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NjAsImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.Ju3FI9kFmShx0rT0RBzbeOCJpcgDDZtGmdZwXID9qziThNkupa-M6tEg1ePUKPMe7T7o_UV4F-lR2S8JeqqPHg
Accept: application/json
Content-Length: 738
Host: localhost:8080
{
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"detail" : "1동 103호",
"zipCode" : "12345",
"size" : "120909000",
"purpose" : "게스트하우스 ( 방3, 화장실 2 )",
"floorNum" : 2,
"contact" : "070-1234-5678",
"createdDate" : "1990",
"price" : 12000,
"monthlyPrice" : 0.0,
"agentName" : "부자부동산",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"code" : "<body> <div> <h2>부자부동산 최신 매물로</h2> </div> <div> <i>게스트하우스용 주택</i>을 소개합니다. </div> </body>",
"imageUrls" : [ "img-001", "img-002", "img-002", "img-002", "img-002" ],
"tmpYn" : false,
"recommendedTag" : [ ]
}Request Fields
| Path | Type | Description |
|---|---|---|
|
|
매매 타입 ( SALE(매매), JEONSE(전세), MONTHLYRENT(월세) )은 필수값입니다. |
|
|
주소는 '시도’로 시작하되, 줄이지 않은 표현으로 작성해야 합니다. 예: 서울시 서대문구 거북골로 34 |
|
|
상세 주소 예: 1동 1호 |
|
|
우편번호 ( string 형식입니다. ) |
|
|
집 크기는 m^2 단위로 산정해서 작성해야 합니다. string 형식입니다. |
|
|
매물 목적/용도 예: 거주 ( 방3, 화장실 2 ) |
|
|
매물이 위치한 층수 ( 단독주택인 경우, null 로 전달 시 서버에서 0으로 세팅 ) |
|
|
연락 가능한 연락처를 01000000000 형식으로 작성 |
|
|
준공연도는 숫자만 입력해주세요. YYYY 형태로 서버에서 관리합니다. |
|
|
매물가격은 만원 단위로 산정해서 작성해주세요. ( 월세의 경우, 보증금을 작성해주세요. ) |
|
|
월세 가격은 만원 단위로 산정해서 소수점 포함으로 작성해주세요. Double 형식으로 관리합니다. |
|
|
공인중개사명을 작성해주세요. ( 없는 경우, 서버에서 null로 관리합니다. ) |
|
|
빈집 게시글의 제목을 입력해주세요. |
|
|
빈집 게시글의 내용을 입력해주세요. |
|
|
이미지 주소를 string 배열 형식으로 입력해주세요. |
|
|
임시저장 여부를 입력해주세요. (임시저장 : true, 저장: false) |
|
|
추천태그를 입력해주세요.( 없는 경우, 빈 문자열 리스트로 보내주세요. ) |
Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 65
{
"code" : "SUCCESS",
"message" : "성공",
"data" : 4030
}3. 빈집 게시글 삭제하기
삭제 시, 빈집 게시글 아이디를 path-variable로 넘겨주세요.
Request
DELETE /api/v1/houses/4029 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NTksImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.-qn2SMFZQ_oc8QAuVHbajtHuMd9onfFAIeYHHhU6NsmaZjCLipWp7hFm_x4xaXLjGOfaM3TWIF9e_JJg-dr-Cg
Accept: application/json
Host: localhost:8080Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 48
{
"code" : "SUCCESS",
"message" : "성공"
}4. 빈집 게시글 목록 조회
빈집 게시글 목록 조회 시, param에 따라 필터링을 거칩니다. 내부적으로 신고여부, 삭제여부, 일반유저의 게시글 승인여부, 임시저장여부 에 대한 필터링을 거칩니다.
임시저장 상태의 게시글을 조회하고 싶은 경우, 8번 API를 호출해주세요.
한 페이지에 기본 8개를 제공합니다. 개수를 조절하고 싶은 경우 요청 쿼리에 size 를 포함해주세요.
게시글 키워드 검색에 대상은 게시글의 제목과 작성자의 닉네임으로 제한합니다. ( 기능 명세서 참고 )
추가 ( 2023.08.23 )
요청 쿼리 Param에서 모든 값은 선택값입니다. 즉, /api/v1/houses 로 보내도 응답이 돌아갑니다.
dealState는 판매 여부를 의미하며, 판매여부에 상관없이 조회하고 싶다면 null 혹은 blank로 보내면 됩니다. 서버 측에서 enum으로 관리되기에 하단 표에 명시한 고유 값으로 보내야 검색이 수행됩니다.
Request
GET /api/v1/houses?rentalType=SALE&city=%EC%84%9C%EC%9A%B8&search=&recommendedTag=&dealState=&page=0 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080Request Fields
| Parameter | Description |
|---|---|
|
매매 타입 |
|
지역 필터링 |
|
추천 태그명 |
|
검색어 |
|
판매 여부 ( 진행중 : ONGOING | 완료 : COMPLETED ) |
|
0부터 시작 |
Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 4228
{
"code" : "SUCCESS",
"message" : "성공",
"data" : {
"content" : [ {
"houseId" : 4130,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.791+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4128,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.788+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4126,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.785+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4124,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.781+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4122,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.778+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4120,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.774+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4118,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.770+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4116,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.766+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
} ],
"size" : 8,
"totalElements" : 11,
"last" : false,
"totalPages" : 2,
"first" : true,
"number" : 0,
"sort" : {
"empty" : true,
"unsorted" : true,
"sorted" : false
},
"numberOfElements" : 8,
"empty" : false
}
}Response Fields
| Path | Type | Description |
|---|---|---|
|
|
빈집 게시글 ID |
|
|
매매 타입 |
|
|
매물 위치 |
|
|
매물 가격 |
|
|
월세 가격 |
|
|
게시글 작성자 |
|
|
게시글 작성날짜 |
|
|
거래 완료 여부 |
|
|
썸네일 이미지 주소 |
|
|
게시글 제목 |
|
|
추천 태그명 리스트 |
|
|
추천 태그명 한글 리스트 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
5. 빈집 게시글 단일 조회 - 비로그인 상태
해당 API는 비로그인 상태일 때, 빈집 게시글 상세 조회 API 입니다.
Request
GET /api/v1/houses/4132 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 1010
{
"code" : "SUCCESS",
"message" : "성공",
"data" : {
"houseId" : 4132,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"detail" : "1동 103호",
"zipCode" : "12345",
"size" : "120909000",
"purpose" : "주거용 ( 방3, 화장실 2 )",
"floorNum" : 2,
"contact" : "070-1234-5678",
"createdDate" : "1990",
"price" : 12000,
"monthlyPrice" : 0.0,
"agentName" : "행복부동산",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"code" : "<body> <div> <h2>행복부동산 최신 매물로</h2> </div> <div> <i>주거용 주택</i>을 소개합니다. </div> </body>",
"imageUrls" : [ "img-001", "img-002", "img-002", "img-002", "img-002" ],
"nickName" : "테스트유저1",
"userType" : "NONE",
"createdAt" : "2024-03-25T12:11:02.012+00:00",
"isCompleted" : false,
"isScraped" : false,
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}
}Response Fields
| Path | Type | Description |
|---|---|---|
|
|
결과 코드 |
|
|
응답 메세지 |
|
|
빈집 게시글 아이디 |
|
|
매물 타입 |
|
|
매물 위치 |
|
|
상세 주소 예: 1동 1호 |
|
|
우편 주소 |
|
|
매물 크기 ( 견적 ) |
|
|
매물 목적/용도 |
|
|
매물 층수 |
|
|
연락 가능한 연락처 |
|
|
준공연도 |
|
|
매물 가격 |
|
|
월세 가격 |
|
|
공인중개사명 |
|
|
게시글 제목 |
|
|
게시글 내용 |
|
|
게시글 이미지 주소 |
|
|
게시글 작성자 |
|
|
게시글 작성자 타입 ( 일반회원 : NONE, 공인중개사 : AGENT ) |
|
|
게시글 작성일자 |
|
|
매물 거래 완료 여부 |
|
|
빈집 게시글 스크랩 여부 |
|
|
빈집 게시글 추천 태그명 |
|
|
빈집 게시글 추천 태그 한글명 |
6. 빈집 게시글 단일 조회 - 로그인 상태
Request
GET /api/v1/houses/user-scrap/4031 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NjAsImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.Ju3FI9kFmShx0rT0RBzbeOCJpcgDDZtGmdZwXID9qziThNkupa-M6tEg1ePUKPMe7T7o_UV4F-lR2S8JeqqPHg
Accept: application/json
Host: localhost:8080Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 1009
{
"code" : "SUCCESS",
"message" : "성공",
"data" : {
"houseId" : 4031,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"detail" : "1동 103호",
"zipCode" : "12345",
"size" : "120909000",
"purpose" : "주거용 ( 방3, 화장실 2 )",
"floorNum" : 2,
"contact" : "070-1234-5678",
"createdDate" : "1990",
"price" : 12000,
"monthlyPrice" : 0.0,
"agentName" : "행복부동산",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"code" : "<body> <div> <h2>행복부동산 최신 매물로</h2> </div> <div> <i>주거용 주택</i>을 소개합니다. </div> </body>",
"imageUrls" : [ "img-001", "img-002", "img-002", "img-002", "img-002" ],
"nickName" : "테스트유저1",
"userType" : "NONE",
"createdAt" : "2024-03-25T12:11:00.448+00:00",
"isCompleted" : false,
"isScraped" : true,
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}
}Response Fields
| Path | Type | Description |
|---|---|---|
|
|
결과 코드 |
|
|
응답 메세지 |
|
|
빈집 게시글 아이디 |
|
|
매물 타입 |
|
|
매물 위치 |
|
|
상세 주소 예: 1동 1호 |
|
|
우편 주소 |
|
|
매물 크기 ( 견적 ) |
|
|
매물 목적/용도 |
|
|
매물 층수 |
|
|
연락 가능한 연락처 |
|
|
준공연도 |
|
|
매물 가격 |
|
|
월세 가격 |
|
|
공인중개사명 |
|
|
게시글 제목 |
|
|
게시글 내용 |
|
|
게시글 이미지 주소 |
|
|
게시글 작성자 |
|
|
게시글 작성자 타입 ( 일반회원 : NONE, 공인중개사 : AGENT ) |
|
|
게시글 작성일자 |
|
|
매물 거래 완료 여부 |
|
|
빈집 게시글 스크랩 여부 ( 로그인 상태일 때, 상세 조회 시 유저 데이터로부터 스크랩 여부를 판단합니다. ) |
|
|
빈집 게시글 추천 태그명 |
|
|
빈집 게시글 추천 태그 한글명 |
7.빈집 게시글 신고하기
해당 API는 허위 매물 혹은 잘못된 정보 제공에 대한 게시글 신고 기능을 제공합니다. 단, 본인의 게시글은 신고할 수 없습니다.
Request
PUT /api/v1/houses/report/4054 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0Ml9qaG91c2VfY29tIiwiZXhwIjoxNzExMzcwNDYwLCJhdXRoIjoiVVNFUiIsInR5cGUiOiJOT05FIn0.6eZNUdxTt0TnU-fs_V_WWmBUPAuqVKQHZQdGCj80oc7NhJkPb3mtr-CmqdTv4MeL6dk4EqnZT7ZdZ-VtRujZOg
Accept: application/json
Content-Length: 107
Host: localhost:8080
{
"reportType" : "FAKE_SALE",
"reportReason" : "허위 매물로 게시글을 작성하였습니다."
}Request Fields
| Path | Type | Description |
|---|---|---|
|
|
신고 이유는 필수값입니다. ( 최소 1자이상 최대 100자 이하로 작성해야 합니다. ) |
|
|
신고 분류는 필수값입니다. ( FAKE_SALE : 허위매물, ADVERTISING_BOARD : 스팸게시글/광고 , ETC : 기타 ) |
Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 48
{
"code" : "SUCCESS",
"message" : "성공"
}8. 임시저장된 게시글 목록 조회하기
본인이 작성한 게시글 중 임시저장 상태의 게시글 데이터만 목록으로 반환합니다. 따라서 토큰이 필요합니다!
Request
GET /api/v1/houses/tmp-save?page=0&size=8 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NjEsImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.xuCnVr2sXQCzCUunE1tHXvgDjKi_NxaXbsWY5aXNv2ThqOG6zp8quQXpoZw2u224s-o55U4dZyzECJnMut9LDA
Accept: application/json
Host: localhost:8080Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 4468
{
"code" : "SUCCESS",
"message" : "성공",
"data" : {
"content" : [ {
"houseId" : 4099,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.445+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4100,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.446+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4101,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.447+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4102,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.448+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4103,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.449+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4104,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.451+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4105,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.453+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4106,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:11:01.455+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
} ],
"pageable" : {
"sort" : {
"empty" : true,
"unsorted" : true,
"sorted" : false
},
"offset" : 0,
"pageSize" : 8,
"pageNumber" : 0,
"paged" : true,
"unpaged" : false
},
"last" : false,
"totalElements" : 11,
"totalPages" : 2,
"first" : true,
"size" : 8,
"number" : 0,
"sort" : {
"empty" : true,
"unsorted" : true,
"sorted" : false
},
"numberOfElements" : 8,
"empty" : false
}
}Response Fields
| Path | Type | Description |
|---|---|---|
|
|
빈집 게시글 ID |
|
|
매매 타입 |
|
|
매물 위치 |
|
|
매물 가격 |
|
|
월세 가격 |
|
|
게시글 작성자 |
|
|
게시글 작성날짜 |
|
|
거래 완료 여부 |
|
|
썸네일 이미지 주소 |
|
|
게시글 제목 |
|
|
추천 태그명 리스트 |
|
|
추천 태그명 한글 리스트 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9. 스크랩한 게시글 목록 조회하기
Request
GET /api/v1/houses/scrap?page=0&filter= HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NTksImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.-qn2SMFZQ_oc8QAuVHbajtHuMd9onfFAIeYHHhU6NsmaZjCLipWp7hFm_x4xaXLjGOfaM3TWIF9e_JJg-dr-Cg
Host: localhost:8080Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 3498
{
"code" : "SUCCESS",
"message" : "성공",
"data" : {
"content" : [ {
"houseId" : 4017,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:10:59.644+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4018,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:10:59.668+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4019,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:10:59.675+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4020,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:10:59.681+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4021,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:10:59.687+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
}, {
"houseId" : 4022,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"price" : 12000,
"monthlyPrice" : 0.0,
"nickName" : "테스트유저1",
"createdAt" : "2024-03-25T12:10:59.692+00:00",
"isCompleted" : false,
"imageUrl" : "img-001",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"recommendedTag" : [ ],
"recommendedTagName" : [ ]
} ],
"pageable" : {
"sort" : {
"empty" : true,
"unsorted" : true,
"sorted" : false
},
"offset" : 0,
"pageSize" : 10,
"pageNumber" : 0,
"paged" : true,
"unpaged" : false
},
"last" : true,
"totalElements" : 6,
"totalPages" : 1,
"first" : true,
"size" : 10,
"number" : 0,
"sort" : {
"empty" : true,
"unsorted" : true,
"sorted" : false
},
"numberOfElements" : 6,
"empty" : false
}
}10. 마이페이지 게시글 목록 조회하기 (공인중개사)
Request
GET /api/v1/houses/agent?page=0&search=&isCompleted= HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZ2VudF9qaG91c2VfY29tIiwiZXhwIjoxNzExMzcwNDYxLCJhdXRoIjoiVVNFUiIsInR5cGUiOiJBR0VOVCJ9.WBh3IpB4ZWCLp3tHricK4K_Od6EtFUBmb3kB8Wm4Yw_r8j5JsO2-sbCAv906FyuaT55wOHbKMa7VD-4A9fW5oQ
Accept: application/json
Host: localhost:8080Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 3663
{
"code" : "SUCCESS",
"message" : "성공",
"data" : {
"content" : [ {
"houseId" : 4077,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4078,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4079,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4080,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4081,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4082,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4083,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4084,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4085,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4086,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
} ],
"size" : 10,
"totalElements" : 22,
"count" : {
"all" : 22,
"applying" : 0,
"ongoing" : 11,
"completed" : 11
},
"last" : false,
"totalPages" : 3,
"first" : true,
"number" : 0,
"sort" : {
"empty" : true,
"unsorted" : true,
"sorted" : false
},
"numberOfElements" : 10,
"empty" : false
}
}11. 빈집 매물 상태 변경하기
본인이 작성한 게시글에 한해서만 상태 변경이 가능합니다. 재등록을 서버 측에서 제한하지 않았기에 클라이언트 측에서 재변경이 안되도록 이벤트를 걸어주셔야 합니다.
리뷰 내용은 필수값은 아니지만, 점수는 필수로 입력해야 하며 이는 양의 정수로 1~5까지 표현할 수 있습니다.
Request
PUT /api/v1/houses/status/4028 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NTksImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.-qn2SMFZQ_oc8QAuVHbajtHuMd9onfFAIeYHHhU6NsmaZjCLipWp7hFm_x4xaXLjGOfaM3TWIF9e_JJg-dr-Cg
Accept: application/json
Content-Length: 158
Host: localhost:8080
{
"score" : 5,
"review" : "It's Good!",
"nickName" : "테스트유저2",
"age" : "30대",
"contact" : "010-1111-1111",
"dealDate" : "2023-01-01"
}Request Fields
| Path | Type | Description |
|---|---|---|
|
|
만족도 점수는 0 ~ 5까지 정수로 표현해야 합니다. ) |
|
|
리뷰 내용은 선택값 입니다.. |
|
|
닉네임은 선택값 입니다. 없을 경우 null 혹은 빈 문자열로 보내주세요. |
|
|
나이는 선택값 입니다. 10대, 20대, 30대와 같이 string 타입으로 보내주셔야 합니다. |
|
|
구매자 연락처는 필수값 입니다. |
|
|
거래 날짜는 필수값 입니다. |
Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 48
{
"code" : "SUCCESS",
"message" : "성공"
}12. 자신이 작성한 빈집 게시글 목록 조회하기
일반 유저 게시글 생성 시, dealState(판매상태)는 APPLYING(승인중)으로 기본 설정됩니다.
일반 유저의 게시글이 관리자로부터 승인 처리가 되면, 빈집 중개 서비스 페이지에서 노출되며 dealState(판매상태)는 ONGOING(판매중)으로 변경됩니다.
일반 유저가 직접 판매완료로 상태변경하면, dealState(판매상태)는 COMPLETED(판매완료)로 변경됩니다.
해당 플로우를 참고해주시기 바랍니다.
Request
GET /api/v1/houses/my?keyword=&dealState= HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJ0ZXN0X2pob3VzZV9jb20iLCJleHAiOjE3MTEzNzA0NjAsImF1dGgiOiJVU0VSIiwidHlwZSI6Ik5PTkUifQ.Ju3FI9kFmShx0rT0RBzbeOCJpcgDDZtGmdZwXID9qziThNkupa-M6tEg1ePUKPMe7T7o_UV4F-lR2S8JeqqPHg
Accept: application/json
Host: localhost:8080Request Fields
| Parameter | Description |
|---|---|
|
매물명 키워드 검색 |
|
거래상태 필터링 ( 승인중 : APPLYING | 진행중 : ONGOING | 완료 : COMPLETED | 반려 : REJECTED) |
Response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/json;charset=UTF-8
Content-Length: 3663
{
"code" : "SUCCESS",
"message" : "성공",
"data" : {
"content" : [ {
"houseId" : 4055,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4056,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4057,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4058,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4059,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4060,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4061,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4062,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
}, {
"houseId" : 4063,
"rentalType" : "SALE",
"city" : "서울시 서대문구 남가좌동 거북골로 34",
"title" : "행복부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "ONGOING",
"dealStateName" : "판매중"
}, {
"houseId" : 4064,
"rentalType" : "JEONSE",
"city" : "서울시 서대문구 남가좌동 거북골로 90",
"title" : "부자부동산에서 제공하는 서울시 빈집 매물입니다.",
"imageUrl" : "img-001",
"dealState" : "COMPLETED",
"dealStateName" : "판매완료"
} ],
"size" : 10,
"totalElements" : 22,
"count" : {
"all" : 22,
"applying" : 0,
"ongoing" : 11,
"completed" : 11
},
"last" : false,
"totalPages" : 3,
"first" : true,
"number" : 0,
"sort" : {
"empty" : true,
"unsorted" : true,
"sorted" : false
},
"numberOfElements" : 10,
"empty" : false
}
}Response Fields
| Path | Type | Description |
|---|---|---|
|
|
빈집 게시글 ID |
|
|
매매 타입 |
|
|
매물 위치 |
|
|
썸네일 이미지 주소 |
|
|
게시글 제목 |
|
|
매물 거래 상태 |
|
|
매물 거래 상태명 |
|
|
전체 개수 (totalElements와 동일한 값) |
|
|
승인중 게시물 개수 |
|
|
판매중 게시물 개수 |
|
|
판매완료 게시물 개수 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|