부동산 통계정보 API를 활용해보자 (2) - API 테스트

https://www.reb.or.kr/r-one/portal/openapi/openApiListPage.do

API목록은 위 링크에서 조회할 수 있다. (로그인 하지 않으면 제대로 못보는듯하다)

`서비스 통계목록`을 클릭하여 들어간다.

키, 타입, 인덱스, 사이즈를 필수로 요구하고, 테이블 ID는 옵션으로 요구하는 느낌이다.

사실 내가 원하는 통계표의 데이터 주기가 어느 단위인지 알기위해서 (연간, 반기, 분기, 월간, 주간 등) 해당 테이블 ID로 조회해볼 필요가 있다.

 

통계표 코드는 https://www.reb.or.kr/r-one/portal/openapi/openApiGuideCdPage.do 에서 확인할 수 있다.

 

내가 예제로 사용할 데이터인

`임대동향 지역별 임대가격지수(2022년~)_오피스` 통계표의 경우, ID는 `A_2024_00234`이다.

 

기술문서상의 서비스 URL은 ` https://www.reb.or.kr/r-one/openapi/서비스명?KEY=인증키` 같은 식으로 사용한다. 그런데 서비스 통계목록, 통계 조회 조건 설정에서 주기코드는 필수이기때문에, KEY 및 테이블ID뒤에 &를 붙여 추가 쿼리가 들어가야한다.

샘플 테스트의 API결과 중 <DATACYCLE_NM> 태그를 보면, 분기단위 데이터임을 알 수 있다.

실제 API를 조회할 떄는 그 위인 <DATACYCLE_CD> 태그의 코드값 (2자리 문자열)을 넣어서 조회하면 된다.

 

https://www.reb.or.kr/r-one/openapi/SttsApiTblData.do?STATBL_ID=A_2024_00234&DTACYCLE_CD=QY

 

내가 조회할 데이터는 분기단위로 제공하니까, `DTACYCLE_CD=QY`를 붙여주면 되는거다. 다른 코드인 YY/HY/MM/WK같은 값을 넣으면 데이터가 없다고 온다.

 

통계코드를 검색할 때, 필수값인 주기코드를 같이 볼 수 없고, 테스트를 해야만 리턴으로 알 수 있는 부분은 조금 불편하다. 코드조회 팝업이아니더라도, 엑셀에서 제공하는 데이터의 타입을 명시해주면 어떨까 싶은 생각이 든다.

아니면, 하나의 주기 유형만 제공하는 데이터에서는 주기코드가 필수가 아니게 작동했으면 좋겠다. (이쪽이 개발적으로 더 어렵지 않을까 싶다 ㅋㅋ)