공공조달 일을 오래 하다 보면 언젠가는 시스템 담당자나 개발 부서로부터 "그 데이터 우리 시스템에 연동할 수 없느냐"는 질문을 받게 됩니다. 다수공급자계약 품목 정보든, 낙찰 정보든 조달청이 보유한 데이터를 자동으로 끌어다 쓰고 싶다는 요청이지요.
이럴 때 필요한 것이 바로 조달데이터허브의 오픈API입니다.
문제는 이 오픈API 목록이 어디에 있는지, 그리고 목록을 찾았다 해도 그 안의 정보를 어떻게 읽어야 할지 막막해하는 실무자가 많다는 점입니다. 개발 언어를 몰라도, 화면만 제대로 짚어가면 필요한 정보는 다 나와 있습니다. 오늘은 그 순서를 차근차근 짚어드리겠습니다.
1단계. 조달데이터허브 메인에서 오픈API 목록 찾기
조달데이터허브 시스템에 접속하면 메인 화면 상단이나 메뉴 어딘가에 데이터 제공이라는 항목이 보일 것입니다. 이 메뉴 안에 오픈API 목록이라는 하위 메뉴가 있는데, 여기를 클릭하면 조달청이 제공하는 API 서비스가 한 화면에 쭉 펼쳐집니다.
처음 이 화면을 마주하면 항목이 많아 당황스러울 수 있습니다만, 걱정할 것 없습니다. 검색 조건만 제대로 걸면 원하는 것만 골라낼 수 있게 설계되어 있습니다.
데이터제공 메뉴에서 오픈API 목록 진입
2단계. 검색 조건으로 필요한 API 좁혀 찾기
화면 상단에는 검색 조건란이 있습니다. 실무에서 가장 유용한 조건은 아래와 같습니다.
- 업무 구분 - 어떤 업무 영역의 데이터인지 (예: 계약, 입찰 등)
- 단계 구분 - 조달 프로세스상 어느 단계에 해당하는지
- 작성일자 - 해당 API 정보가 언제 등록·수정되었는지
- 서비스명 - 이름을 알고 있다면 바로 검색 가능
이 조건들을 조합해 선택한 뒤 검색 버튼을 누르면, 조건에 맞는 오픈API 목록만 추려져서 화면에 나타납니다. 처음 이 시스템을 다루는 분이라면 서비스명을 정확히 모르는 경우가 대부분이니, 업무 구분부터 넓게 잡고 좁혀가는 방식을 권합니다.
검색조건 선택 후 목록 확인 화면
💡 지금 이 분야 공고가 얼마나 올라와 있는지 궁금하다면 모두입찰에서 바로 검색해 볼 수 있습니다.
3단계. 서비스명 클릭해서 상세 정보 확인하기
목록에서 원하는 항목의 서비스명 링크를 클릭하면 해당 API의 상세 화면으로 넘어갑니다. 여기가 실질적으로 개발 담당자에게 넘겨줄 핵심 정보가 모두 모여 있는 자리입니다.
상세 화면 상단에는 서비스명, 데이터 포맷 같은 기본 정보가 정리되어 있고, 그 아래로 API 기능 정보, 요청 변수, 출력 결과, 샘플 URL, 메시지 정보까지 탭 형태로 나뉘어 있습니다. 각 탭의 역할을 정리하면 다음과 같습니다.
| 탭 이름 | 확인할 수 있는 내용 |
|---|---|
| API 기능 정보 | 선택한 기능의 API 요청 주소(URL) |
| 요청 변수 | API 호출 시 입력해야 하는 변수 항목 |
| 출력 결과 | API 호출 후 응답으로 돌아오는 항목 정보 |
| 샘플 URL | 실제 호출해볼 수 있는 URL 예시 |
| 메시지 | 응답 코드에 대응하는 메시지 안내 |
화면 중앙의 상세 기능 영역에서는 다수공급자계약 품목 정보처럼 세부 항목별 버튼을 눌러 원하는 정보만 따로 조회해볼 수도 있습니다. 그리고 상세 화면 어딘가에는 기술 가이드 문서 다운로드 버튼도 준비되어 있으니, 개발 담당자에게는 이 문서까지 함께 챙겨서 넘겨주시길 바랍니다.
오픈API 상세화면의 탭별 정보
4단계. 다시 목록으로 돌아가기
확인이 끝났다면 화면 하단의 목록 버튼을 눌러 오픈API 목록 화면으로 돌아가면 됩니다. 이런 식으로 필요한 API를 하나씩 확인해가며 연동 대상을 추려나가는 것이 실무에서 가장 효율적인 방식입니다.
자주 막히는 부분 (FAQ)
오픈API 목록을 찾았는데 개발자가 아니어도 볼 필요가 있나요? 그렇습니다. 실무 담당자가 어떤 데이터가 제공되는지 먼저 파악해야 개발 부서에 정확한 요구사항을 전달할 수 있습니다. 상세 화면만 봐도 어떤 정보가 나오는지 충분히 이해할 수 있게 되어 있습니다.
검색 조건을 다 몰라도 검색이 되나요? 됩니다. 업무 구분이나 서비스명 중 하나만 입력해도 검색이 가능하니, 아는 조건부터 우선 걸어보시길 바랍니다.
API 요청 시 인증키 같은 것도 이 화면에서 확인 가능한가요? 이 영상에서는 기술 가이드 문서 다운로드까지 안내하고 있으니, 인증키 발급 절차 등 세부 사항은 해당 문서를 통해 확인하시길 권합니다.
오픈API는 결국 사람이 손으로 하던 조회 작업을 시스템끼리 자동으로 주고받게 해주는 다리 역할을 합니다. 화면 구조만 한 번 제대로 익혀두시면, 이후로는 필요할 때마다 어렵지 않게 찾아 쓰실 수 있을 것입니다.
📌 함께 보면 좋은 글
📺 이 글은 조달청 나라장터 공식 유튜브 영상을 참고해 정리했으며, 본문 화면 이미지는 해당 영상의 캡처입니다. 전체 과정은 영상으로도 확인할 수 있습니다.
'나라장터 사용법' 카테고리의 다른 글
| 나라장터 모바일 인증서 로그인 방법 총정리 (0) | 2026.07.06 |
|---|---|
| 나라장터 통합검색으로 공고 빠르게 찾는 법 (0) | 2026.07.06 |
| 나라장터 개인회원 소속기관 등록하는 법 (0) | 2026.07.05 |
| 나라장터 개인회원 소속기업 등록(대표자) 방법 (0) | 2026.07.05 |
| 나라장터 입찰대리인 등록, 개인회원 소속 선택법 (0) | 2026.07.05 |