본문 바로가기
Software/Python

조달청 입찰/계약 정보 조회용 프로그램 (1/ 2) - 공공데이터포탈 API 분석 및 GUI구성

by lovey25 2021. 3. 19.

조달청에서 제공하는 API를 이용해서 정부 발주 입찰공고 및 계약현황을 조회하는 파이썬 프로그램을 만들어 보려 합니다. 

국가종합 전자조달 홈페이지인 나라장터에서 필요한 정보 조회가 모두 가능하지만 자주 찾아보는 검색조건 등을 저장해 두고 반복적으로 검색해 보거나 데이터를 수집할 용도로 사용할 수 있을 것 같아서 시도해 봤습니다.

파이썬을 이용해서 작성할 예정이고 GUI는 PyQt5. 그리고 수집된 정보는 DB(SQLite)를 활용해서 저장합니다.

API 사용 신청 및 포멧 분석

먼저 API에서 어떤 정보가 가용한지 알아야 하니까 바로 API 신청부터 합니다. 공공데이터포털(www.data.go.kr)로 가서 회원 가입하고 로그인합니다.

조달청 입찰, 조달청 계약 키워드로 검색을 해서 다음과 같이 오픈 API 섹션에서 "조달청_입찰공고정보", "조달청_계약정보" 2가지를 활용 신청합니다.

신청하고 나면 즉시 승인이 되고 사용 가능한 상태가 되는데요. 마이페이지에 가면 신청한 API를 확인할 수 있습니다.

API 목록을 클릭해보면 상세 정보를 확인할 수 있는데 API 호출에 사용되는 인증키, 그리고 호출 주소, 데이터 포맷 등에 대한 정보를 확인할 수 있습니다.

이제 어떤 포멧과 변수를 이용해서 데이터를 요청해야 하는지 그리고 응답 메시지는 어떤 정보가 있고 어떤 포맷으로 되어 있는지를 확인해 보겠습니다. 4가지 API모두 유사하게 동작하기 때문에 본 포스팅에는 "나라장터검색조건에 의한 입찰공고공사조회" 한 가지만 예시로 분석해 보겠습니다.

위의 API 상세정보에서 워드파일로 된 참고 문서를 다운로드하여서 "나라장터검색조건에 의한 입찰공고"를 검색해서 오퍼레이션 명세를 찾습니다.

그 하단에 공사 입찰에 대한 요청 메시지와 응답 메시지의 명세가 표로 정리되어 있는데요. 정말 다양한 변수들을 사용 가능한데요. 그중에서 우선적으로 적용해야겠다고 생각되는 것들을 좀 추려봤습니다.

요청 변수

먼저 데이터를 요청할 때 사용하는 변수들입니다.

항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
numOfRows 한 페이지 결과 수 4 1 10 한 페이지 결과 수
pageNo 페이지 번호 4 1 1 페이지 번호
ServiceKey 서비스키 400 1 인증키 받은 인증키
type 타입 4 0 json JSON으로 받고 싶을 경우 'json'
inqryDiv 조회구분 1 1 1 1:공고게시일시, 2:개찰일시
inqryBgnDt 조회시작일시 12 0 201605010000 "YYYYMMDDHHMM"
inqryEndDt 조회종료일시 12 0 201605052359 "YYYYMMDDHHMM"
bidNtceNm 입찰공고명 100 0    
ntceInsttNm 공고기관명 200 0    
dminsttNm 수요기관명 200 0    
presmptPrceBgn 추정가격시작 25 0 68773000  (원화,)

응답 메시지 포맷

다음으로 회신된 메시지 중에서 뽑아내고 싶은 정보들은 다음과 같습니다.

항목명(영문) 항목명(국문) 항목크기 항목구분 샘플데이터 항목설명
resultCode 결과코드 2 1 00 결과코드
resultMsg 결과메세지 50 1 정상 결과메세지
numOfRows 한 페이지 결과 수 4 1 10 한 페이지 결과 수
pageNo 페이지 번호 4 1 1 페이지 번호
totalCount 전체 결과 수 4 1 1 전체 결과 수
bidNtceNo 입찰공고번호 40 1 20160430911  
bidNtceDt 입찰공고일시 19 0 2016-05-02 08:40:34 YYYY-MM-DD HH:MM:SS
bidNtceNm 입찰공고명 100 1    
dminsttNm 수요기관명 200 1    
presmptPrce 추정가격 25 0    
bidNtceDtlUrl 입찰공고상세URL 512 0    
bidNtceUrl 입찰공고URL 500 0    
untyNtceNo 통합공고번호 11 0 00019991191 입찰공고를 구분하는 번호
stdNtceDocUrl 표준공고서URL 256 0    

대략적으로 어떤 검색이 가능하고 그리고 어떤 정보가 조회 가능한지 확인을 했으니 프로그램을 구상해 보겠습니다.

화면 구성

UI 구성은 이렇게 만들어 봤어요. 더 편리하고 깔끔하게 만들 수도 있겠지만 우선 공부하는 입장에서 가능성 여부를 확인하는 프로토타입 차원에서 최대한 간단하게 구상해 봤습니다.

제공되는 API의 종류에 따라서 4가지 검색 타입을 구분시켰습니다. 조달청 제공 입찰 정보는 방대하지만 제가 관심 두고 있는 부분은 공사와 용역 부분이며 각각의 입찰공고 현황과 계약 현황을 조회하려 합니다. QRadioButton을 각각 만들고 API 종류에 맞게 라벨을 붙였습니다. 

다음으로 검색조건으로는 입찰명, 소요기관, 날짜, 금액 4가지를 선정했습니다. 각 조건값을 입력할 수 있도록 QLineEdit를 배치하였습니다. 날짜는 QDateEdit를 사용해서 날짜 형식을 쉽게 입력할 수 있도록 했습니다. 그리고 단축어처럼 많이 사용할 조건을 쉽게 입력할 수 있게 몇 가지 버튼들 추가했습니다.

그리고 아직 검색한 정보를 어떤 식으로 이용해야 할지 몰라서 일단 검색을 해서 해당되는 정보들이 들어오면 파싱 해서 일단 SQLite에 저장을 하고 저장된 DB를 다시 읽어와서 화면에 뿌려주는 방식으로 만들어 보려 합니다. 그래서 검색 데이터를 요청하는 버튼(QPushButton)을 만들어서 DB다운로드라는 이름을 붙여주었고 그 옆에 저장된 DB를 초기화시켜줄 버튼도 추가했습니다.

그리고 페이지 구분은 나중에 프로그램이 완성돼서 정말 활용을 하게 되면 고민해 보려고 미봉책으로 남겨둔 부분인데요. 한 화면을 넘어가는 검색 결과가 있을 때 뒷페이지 조회를 어떤식으로 할지 몰라서 일단 전체 검색결과 숫자가 어떻게 되는지 그리고 페이지로는 몇 페이지나 나오는지만 표시하고 필요한 경우 페이지 이동을 할 수 있는 부분을 만들어 두었습니다.

마지막으로 화면 하단의 검색시간은 검색조건을 입력하고 데이터를 받아오는 데까지 걸린 시간을 표시하는 부분인데 검색 결과가 없을 때 화면에 아무런 반응이 없으면 오류가 있는 건지 없는 건지 알 수가 없어서 나중에 테스트하는 과정에서 추가했네요.

마무리

이제 본격적인 코딩만 남았습니다. 기본적인 기능 구현은 비교적 쉽게 할 수 있는데 역시 디테일에서 실력의 한계가 드러나네요. 제일 어려운 부분이 남았지만 일단 시작이 반이니까 반은 했다 치고, 여러 가지 시행착오를 거친 다음에 정리가 좀 되면 2부에서 마무리할 계획입니다. 

 

끝!

728x90

댓글0