IT와 보안 그 어디 쯤/웹프로그래밍_끄적이기

국토교통부 실거래가 정보 오픈API 활용 가이드- 아파트 매매 신고 상세자료 조회 -

깊음위에 2023. 5. 23. 08:08
반응형

󰊱 공공데이터 OpenAPI 조회 서비스

 

가. API 서비스 개요

API 서비스 정보 API명(영문) Apartment Transaction Detailed Data
API명(국문) 아파트 매매 신고 상세자료 조회
API 설명 지역코드와 기간을 설정하여 해당지역, 해당기간의 아파트 매매 상세자료를 제공하는 아파트 매매 상세자료 조회
API 서비스 보안적용 기술 수준 서비스 인증/권한 [O] Service Key [ ] 인증서 (GPKI/NPKI)
[ ] BASID(IP/PW) [ ] 없음
메시지 레벨 암호화 [ ] 전자서명 [ ] 암호화 [O] 없음
전송 레벨 암호화 [ ] SSL [O] 없음
인터페이스 표준 [ ] SOAP 1.2 (RPC-Encoded, Document Literal, Document Literal Wrapped) [O] REST (GET) [ ] RSS 1.0
[ ] RSS 2.0 [ ]ATOM 1.0 [ ] 기타
교환 데이터 표준
(중복선택가능)		 [O] XML [ ] JSON [ ] MINE [ ] MTOM
API 서비스 배포정보 서비스 URL http://openapi.molit.go.kr/OpenAPI_ToolInstallPackage/service/rest/RTMSOBJSvc/getRTMSDataSvcAptTradeDev
서비스 명세 URL
(WSDL 또는 WADL)		 http://openapi.molit.go.kr/OpenAPI_ToolInstallPackage/service/rest/RTMSOBJSvc/getRTMSDataSvcAptTradeDev?_wadl&type=xml
서비스 버전 1.0
서비스 시작일 2016.12.01 서비스 배포일 2016.12.01
서비스 이력  
메시지 교환유형 [O] Request-Response [ ] Publish-Subscribe
[ ] Fire-and-Forgot [ ] Notification
서비스 제공자  
데이터 갱신주기 일 1회

 

 

나. 상세기능 목록

번호 API명(국문) 상세기능명(영문) 상세기능명(국문)
1 아파트 매매 신고 상세자료 getRTMSDataSvcAptTradeDev 아파트 매매 신고 상세자료

 

다. 상세기능내역

 

 a) 상세기능정보

상세기능 번호 1 상세기능 유형 조회 (자료)
상세기능명(국문) 아파트 매매 신고 상세자료 조회
상세기능 설명 행정표준코드관리시스템(www.code.go.kr)의 법정동 코드 중 앞5자리(예시 : 서울 종로구 - 11110), 계약년월(예시 : 201801)로 해당 지역, 해당 기간의 아파트 매매신고 상세자료 조회
Call Back URL http://openapi.molit.go.kr/OpenAPI_ToolInstallPackage/service/rest/RTMSOBJSvc/getRTMSDataSvcAptTradeDev
최대 메시지 사이즈 [1000 bytes]
평균 응답 시간 [500] ms 초당 최대 트랙잭션 [30] tps

 

 

 

 b) 요청 메시지 명세

항목명(영문) 항목명(국문) 항목
크기		 항목
구분*		 샘플
데이터		 항목설명
serviceKey 인증키 100 1 인증키
(URL Encode)		 공공데이터포털에서 발급받은 인증키
pageNo 페이지번호 4 0 1 페이지번호
numOfRows 한 페이지 결과 수 4 0 10 한 페이지 결과 수
LAWD_CD 지역코드 5 1 11110 각 지역별 코드 행정표준코드관리시스템(www.code.go.kr)의 법정동코드 10자리 중 앞 5자리
DEAL_YMD 계약월 6 1 201512 실거래 자료의 계약년월(6자리)

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

c) 응답 메시지 명세

 

항목명(영문) 항목명(국문) 항목설명 항목
크기		 항목
구분		 샘플데이터
resultCode 결과코드 결과코드 2 1 00
resultMsg 결과메세지 결과메세지 50 1 NORMAL SERVICE.
numOfRows 한 페이지 결과 수 한 페이지 결과 수 4 1 10
pageNo 페이지 번호 페이지 번호 4 1 1
totalCount 전체 결과 수 전체 결과 수 4 1 3
Deal Amount 거래금액 거래금액(만원) 40 1 82,500
Build Year 건축년도 건축년도 4 1 2008
Deal Year 년 계약년도 4 1 2015
Road Name 도로명 도로명 20 1 사직로8길
Road Name Bonbun 도로명건물본번호코드 도로명건물본번 5 1 00004
Road Name Bubun 도로명건물부번호코드 도로명건물부번 5 1 00000
Road Name Sigungu Code 도로명시군구코드 도로명시군구코드 5 1 11110
Road Name Seq 도로명일련번호코드 도로명코드 2 1 03
Road Name Basement Code 도로명지상지하코드 도로명지상지하코드 1 1 0
Road Name Code 도로명코드 도로명코드 7 1 4100135
Dong 법정동 법정동 40 1  사직동
Bonbun 법정동본번코드 법정동본번코드 4 1 0009
Bubun 법정동부번코드 법정동부번코드 4 1 0000
Sigungu Code 법정동시군구코드 대상물건의 시군구코드 5 1 11110
Eubmyundong Code 법정동읍면동코드 대상물건의 읍면동코드 5 1 11500
Land Code 법정동지번코드 법정동지번코드 1 1 1
Apartment Name 아파트 아파트명 40 1 광화문풍림스페이스본(9-0)
Deal Month 월 계약월 2 1 12
Deal Day 일 일 6 1 1
일련번호 일련번호 일련번호 14 1 11110-2203
Area for Exclusive Use 전용면적 전용면적(㎡) 20 1 94.51
Jibun 지번 지번 10 1 9
Regional Code 지역코드 지역코드 5 1 11110
Floor 층 층 4 1 11
Cancel Deal Type 해제여부 해제여부 1 0 O
Cancel Deal Day 해제사유발생일 해제사유발생일 8 0 21.01.27
REQ GBN 거래유형 중개 및 직거래 여부 10 1 중개거래
Rdealer Lawdnm 중개업소주소 시군구 단위 150 1 서울 서초구

 

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

※ 신규 추가 항목은 빨간색으로 표시해 두었음

 

d) 요청/응답 메시지 예제

요청메시지
http://openapi.molit.go.kr/OpenAPI_ToolInstallPackage/service/rest/RTMSOBJSvc/getRTMSDataSvcAptTradeDev?LAWD_CD=11110&DEAL_YMD=201512&serviceKey=서비스키
응답 메시지
<?xml version="1.0" encoding="UTF-8" standalone="true"?>
<response>
<header>
<resultCode>00</resultCode>
<resultMsg>NORMAL SERVICE.</resultMsg>
</header>
<body>
<item>
<거래금액>82,500</거래금액>
<건축년도>2008</건축년도>
<년>2015</년>
<도로명>사직로8길</도로명>
<도로명건물본번호코드>00004</도로명건물본번호코드>
<도로명건물부번호코드>00000</도로명건물부번호코드>
<도로명시군구코드>11110</도로명시군구코드>
<도로명일련번호코드>03</도로명일련번호코드>
<도로명지상지하코드>0</도로명지상지하코드>
<도로명코드>4100135</도로명코드>
<법정동>사직동</법정동>
<법정동본번코드>0009</법정동본번코드>
<법정동부번코드>0000</법정동부번코드>
<법정동시군구코드>11110</법정동시군구코드>
<법정동읍면동코드>11500</법정동읍면동코드>
<법정동지번코드>1</법정동지번코드>
<아파트>광화문풍림스페이스본(9-0)</아파트>
<월>12</월>
<일>1</일>
<전용면적>94.51</전용면적>
<지번>9</지번>
<지역코드>11110</지역코드>
<층>11</층>
<해제여부>O</해제여부>
<해제사유발생일>20200221</해제사유발생일>
<거래유형>중개거래</거래유형>
<중개업소주소>서울 서초구</중개업소주소>
</item>
</body>
</response>

󰊲 OpenAPI 에러 코드정리

 

OPEN API 에러 코드 별 조치방안

code 코드값 설명 조치방안
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나 도메인의 정보를 변경하기 위해 변경신청을 할 수 있습니다.		 "이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

반응형
저작자표시 비영리 변경금지

'IT와 보안 그 어디 쯤 > 웹프로그래밍_끄적이기' 카테고리의 다른 글

국토교통부 실거래가 정보오픈API 활용 가이드 - 아파트 전월세 신고정보 조회 -  (0) 2023.05.23
국토교통부 실거래가 정보 오픈API 활용 가이드연립다세대 전월세 신고정보 조회 -  (0) 2023.05.23
국토교통부 실거래가 정보 오픈API 활용 가이드- 연립다세대 매매 신고정보 조회 -  (0) 2023.05.23
[PHP]다른 페이지에 변수 전달  (0) 2017.06.13
[PHP]동영상 thumbnail 만들기  (0) 2017.06.13

'IT와 보안 그 어디 쯤/웹프로그래밍_끄적이기'의 다른글

  • 현재글국토교통부 실거래가 정보 오픈API 활용 가이드- 아파트 매매 신고 상세자료 조회 -

관련글

댓글

티스토리툴바