부동산 거래 신고된 아파트의 전월세 정보 조회
상세기능 번호
1
상세기능 유형
조회 (자료)
상세기능명(국문)
아파트 전월세 신고정보
상세기능 설명
행정표준코드관리시스템(www.code.go.kr)의 법정동 코드 중 앞5자리(예시 : 서울 종로구 - 11110), 계약년월(예시 : 201801)로 해당 지역, 해당 기간의 아파트 전월세 신고정보를 조회
Call Back URL
https://i48ojxo10p.apigw.ntruss.com/public_apartment/v1/rent-data
최대 메시지 사이즈
1000 bytes
평균 응답 시간
500 ms
초당 최대 트랙잭션
30 tps
부동산 거래 신고된 아파트의 전월세 정보 조회 API
GET https://4vh6qtie3c.apigw.ntruss.com/public_apartment/v1/rent-data
Query Parameters
LAWD_CD*
string
DEAL_YMD*
string
실거래 자료의 계약년월(6자리)
Headers
Authorization*
string
사용자ID;secret key
Response Body
resultCode
결과코드
결과코드
2
Y
00
resultMsg
결과메세지
결과메세지
50
Y
NORMAL SERVICE.
Use Request Renewal Contract Right
갱신요구권사용
갱신요구권사용
10
N
사용
Build Year
건축년도
건축년도
4
Y
1993
Contract Type
계약구분
계약구분
10
N
갱신
Term of Contract
계약기간
계약기간
20
N
22.02~24.02
Deal Year
년
계약년도
4
Y
2022
Dong
법정동
법정동
40
Y
창신동
Deposit
보증금액
보증금(만원)
10
Y
28,300
Apartment Name
아파트
아파트명
40
Y
창신쌍용2
Deal Month
월
계약월
2
Y
1
Monthly Rent
월세금액
월세(만원)
10
Y
0
Deal Day
일
일
6
Y
26
Area for Exclusive Use
전용면적
전용면적(㎡)
20
Y
54.7
Previous Deposit
종전계약보증금
종전계약보증금
20
N
27,000
Previous Monthly Rent
종전계약월세
종전계약월세
20
N
0
Jibun
지번
지번
10
Y
703
Regional Code
지역코드
지역코드
5
Y
11110
Floor
층
층
4
Y
3
요청 및 응답 예시
https://i48ojxo10p.apigw.ntruss.com/public_apartment/v1/rent-data?LAWD_CD=11110&DEAL_YMD=201512
에러 코드 별 조치방안
01
Application Error
제공기관 서비스 제공 상태가 원활하지 않습니다.
서비스 제공기관의 관리자에게 문의하시기 바랍니다.
02
DB Error
제공기관 서비스 제공 상태가 원활하지 않습니다.
서비스 제공기관의 관리자에게 문의하시기 바랍니다.
03
No Data
데이터없음 에러
04
HTTP Error
제공기관 서비스 제공 상태가 원활하지 않습니다.
서비스 제공기관의 관리자에게 문의하시기 바랍니다.
05
service time out
제공기관 서비스 제공 상태가 원활하지 않습니다.
서비스 제공기관의 관리자에게 문의하시기 바랍니다.
10
잘못된 요청 파라미터 에러
OpenApi 요청시 ServiceKey 파라미터가 없음
•OpenAPI 요청 값에서 ServiceKey 파라미터가 누락되었습니다.
•OpenAPI 요청 URL을 확인하시기 바랍니다.
11
필수 요청 파라미터가 없음
요청하신 OpenApi의 필수 파라미터가 누락되었습니다.
기술문서를 다시 한번 확인하시어 주시기 바랍니다.
12
해당 오픈 API 서비스가 없거나 폐기됨
OpenApi 호출시 URL이 잘못됨
•제공기관 관리자에게 폐기된 서비스인지 확인합니다.
폐기된 서비스가 아니면 개발가이드에서 OpenApi 요청 URL을 다시 확인하시기 바랍니다.
20
서비스 접근 거부
활용승인이 되지 않은 OpenApi 호출
•OpenApi활용 신청정보의 승인상태를 확인하시기 바랍니다.
•활용신청에 대해 제공기관 담당자가 확인 후 ‘승인’이후부터 사용할 수 있습니다.
•신청 후 2~3일이 소요되고 결과는 회원가입 시 등록한 e-mail로 발송합니다.
22
서비스 요청 제한 횟수 초과 에러
일일 활용건수가 초과함
(활용건수 증가 필요)
•OpenAPI 활용신청정보의 서비스 상세기능별 일일트랙픽량을 확인하시기 바랍니다.
•개발계정의 경우 제공기관에서 정의한 트래픽을 초과하여 활용할 수 없습니다.
•운영계정의 경우 변경신청을 통해서 일일트래픽량을 변경할 수 있습니다.
30
등록되지 않은 서비스키
잘못된 서비스키를 사용하였거나 서비스키를 URL 인코딩하지 않음
•OpenAPI 활용신청정보의 발급받은 서비스키를 다시 확인하시기 바랍니다.
•서비스키 값이 같다면 서비스키가 URL 인코딩 되었는지 다시 확인하시기 바랍니다.
31
기간 만료된 서비스키
OpenApi 사용기간이 만료됨
(활용연장신청 후 사용가능)
•OpenAPI 활용신청정보의 활용기간을 확인합니다.
•활용기간이 지난 서비스는 이용할 수 없으며 연장신청을 통해 승인받은 후 다시 이용이 가능합니다.
32
등록되지 않은 도메인명 또는 IP 주소
활용신청한 서버의 IP와 실제 OpenAPI호출한 서버가 다를 경우
•OpenAPI활용신청정보의 등록된 도메인명이나 IP주소를 다시 확인합니다.
•IP나 도메인의 정보를 변경하기 위해 변경신청을 할 수 있습니다.
Was this helpful?