나의 도구 #59 | 국가자산 공매정보 조회

공공데이터포털에는 우리 생활에 유용한 수많은 오픈 API가 개방되어 있습니다. 그중에서도 금융위원회에서 제공하는 국가자산공매정보 API는 국유재산 및 공공기관 자산의 대부·매각 정보를 투명하게 조회할 수 있도록 돕는 알짜배기 공공데이터입니다.

이번 글에서는 복잡한 프로그램 설치 없이, 웹 브라우저 하나만으로 전국의 국가자산 공매 및 대부 물건을 실시간으로 검색할 수 있는 웹 애플리케이션을 직접 구축해 본 과정을 공유해 드립니다.

1. 개발 배경과 기획 의도

국가자산 정보는 부동산, 권리/증권 등 다양한 형태로 존재하며 일반 국민이 쉽게 접근해 찾아보기란 쉽지 않습니다. 기존 공공데이터 포털의 문서를 참고하여, 사용자가 직관적으로 시도별, 자산 대분류 및 소분류별로 조건을 선택해 곧바로 결과를 확인할 수 있는 전용 인터페이스를 구상했습니다.

특히 사용자 편의성을 높이기 위해 다음과 같은 부분에 중점을 두었습니다.

• 직관적인 3단 검색 필터: 시도, 대분류(부동산, 권리/증권 등), 소분류를 연동하여 원하는 카테고리를 정확히 타겟팅할 수 있도록 구성했습니다.
• 반응형 다자간 디자인: 라이트 모드와 다크 모드를 손쉽게 전환할 수 있도록 구현하여 모바일과 PC 어디서나 쾌적하게 이용할 수 있습니다.

2. 주요 기능 및 화면 구성

구현된 웹 서비스는 깔끔한 카드 UI 형식을 채택하여 감정평가액, 최저공매가, 토지 및 건물 면적 핵심 지표를 한눈에 파악할 수 있도록 만들었습니다.

• 실시간 조건 검색: 전국 단위 혹은 특정 지역(서울특별시, 경기도 등)을 지정하고, 부동산 세부 용도(토지, 근린생활시설, 공장, 빌딩 등)에 따른 물건을 실시간으로 필터링합니다.
• 상세 정보 아코디언 레이아웃: 요약 카드 위를 클릭하면 물건관리번호, 공매번호, 담당자 연락처, 처분 조건, 명도 책임 등 숨겨진 방대한 상세 데이터가 부드럽게 펼쳐집니다.

3. 기술적 특징 및 활용 팁

이 프로젝트는 별도의 무거운 프레임워크 없이 순수 HTML, CSS, JavaScript 조합으로 가볍고 빠르게 동작하도록 설계되었습니다. Vercel이나 Netlify 같은 정적 호스팅 플랫폼에 몇 초 만에 배포할 수 있어 개인 블로그나 포트폴리오용 위젯으로 활용하기에 최적입니다.

공공데이터 API를 연동할 때 CORS 이슈나 파라미터 형식 오류를 방지하기 위해 URLSearchParams를 활용해 안전하게 쿼리 스트링을 조립하였으며, 데이터가 없을 경우나 네트워크 에러 발생 시 사용자에게 친절한 안내 메시지를 출력하도록 예외 처리를 꼼꼼하게 적용했습니다.

앞으로도 유용한 공공데이터를 활용한 재미있는 웹 유틸리티 개발기를 계속해서 공유해 드리겠습니다.