나라장터 입찰공고 API 인증키 발급 방법, 신청부터 첫 호출까지

2026-10-30 업데이트

나라장터 입찰공고 API 인증키는 공공데이터포털에 로그인한 뒤 "조달청_나라장터 입찰공고정보서비스" 페이지에서 활용신청을 누르면 바로 받을 수 있어요. 이 서비스는 공식 페이지에 개발 단계와 운영 단계 모두 자동승인으로 표시돼 있어요. 2026년 10월 30일에 직접 신청해 보니 제출 직후 마이페이지에 승인 상태로 나타났어요. 아래에서 신청 순서와 첫 호출, 자주 나는 오류까지 차례로 정리해요.

시작 전에 알아 둘 것

공공데이터포털 이용가이드는 오픈API를 누구나 사용할 수 있도록 공개된 API라고 설명해요. 나라장터 입찰공고정보서비스는 그중 조달청이 제공하는 REST 방식 API예요.

항목 공식 페이지 표시 내용
제공기관 조달청 (조달데이터관리팀)
데이터 형식 JSON+XML
비용 무료
업데이트 주기 실시간
심의유형 개발단계·운영단계 모두 자동승인
개발계정 트래픽 1,000 (운영계정은 활용사례 등록 시 증가 신청 가능)

위 표는 데이터셋 페이지에 표시된 내용을 그대로 옮긴 거예요.

1단계: 공공데이터포털 로그인

공공데이터포털 로그인 화면에서는 아이디·비밀번호 외에 네이버, 카카오 간편 로그인을 쓸 수 있어요. 회원이 아니라면 먼저 회원가입을 해야 해요. 직접 신청할 때는 네이버 간편 로그인으로 들어갔고, 별도 서류는 요구받지 않았어요.

2단계: 데이터셋 페이지에서 활용신청

  1. 공공데이터포털 검색창에 "나라장터 입찰공고정보서비스"를 검색하거나 데이터셋 페이지로 바로 들어가요.
  2. 제목 옆의 활용신청 버튼을 눌러요.
  3. "오픈 API 개발계정 신청" 화면이 열려요. 기본 정보에 데이터명, 제공기관, 심의여부(자동승인), 활용기간이 표시돼요.

신청 화면에는 활용기간이 "승인일로부터 24개월 간 활용가능"이라고 나와요. 실제로 신청일 2026-10-30, 만료예정일 2028-10-30으로 표시됐어요.

3단계: 활용목적과 상세기능 선택

입력 항목 무엇을 적나요
활용목적 웹 사이트 개발, 앱 개발 등 선택지 중 하나를 골라요
활용 목적 설명 어떤 서비스에 쓰는지 짧게 적어요
첨부파일 위치정보를 포함한 서비스를 하는 사업자만 해당 서류가 필요하다고 안내돼요
상세기능 용역·물품·공사 등 쓸 오퍼레이션을 체크해요
이용 동의 이용허락범위에 동의해요

상세기능은 업무구분마다 따로 있어요. 데이터셋 설명대로 공사 공고는 공사 오퍼레이션으로 불러와야 정상 응답을 받기 때문에, 필요한 업무구분을 빠짐없이 체크하는 게 좋아요. 모두 입력한 뒤 활용 신청하기를 누르면 끝나요.

4단계: 인증키 확인

마이페이지의 데이터 활용 메뉴에서 오픈 API 활용신청 현황으로 들어가면 신청한 서비스가 "[승인]" 상태로 보여요. 서비스 이름을 누르면 상세 화면에 일반 인증키가 나와요.

포털은 API 환경이나 호출 조건에 따라 인증키 적용 방식이 다를 수 있으니, Encoding 또는 Decoding 키 중 실제로 작동하는 키를 쓰라고 안내해요. 주소창에 직접 넣을 때는 URL 인코딩이 된 값을 쓰고, 코드에서 쿼리 문자열을 만들 때는 원래 값을 넣고 라이브러리가 인코딩하게 하면 돼요.

5단계: 첫 호출 해 보기

용역 공고 목록을 등록일시 기준으로 불러오는 예시예요.

https://apis.data.go.kr/1230000/ad/BidPublicInfoService/getBidPblancListInfoServc
  ?serviceKey=발급받은키
  &pageNo=1&numOfRows=10&type=json
  &inqryDiv=1&inqryBgnDt=202610290000&inqryEndDt=202610302359

발급 직후 같은 조건으로 호출해 보니 결과코드 00과 함께 이틀 치 용역 공고 866건이 조회됐어요. 응답 항목을 읽는 방법은 입찰공고 응답 항목 읽는 법에 정리했어요.

자주 나는 오류와 해결법

상황 응답 해결
키를 빠뜨렸어요 SERVICE_KEY_IS_NULL, 서비스 접근거부 serviceKey 파라미터 이름과 값을 확인해요
이용 권한이 없어요 SERVICE_ACCESS_DENIED_ERROR (20) 활용신청과 승인 상태를 확인해요
등록되지 않은 키예요 SERVICE_KEY_IS_NOT_REGISTERED_ERROR (30) 키를 정확히 복사했는지, 이 서비스에 신청했는지 봐요
기한이 지났어요 DEADLINE_HAS_EXPIRED_ERROR (31) 포털에서 이용 기간을 확인하고 연장 신청해요
파라미터가 틀렸어요 INVALID_REQUEST_PARAMETER_ERROR (10) 날짜 형식과 필수 값을 다시 봐요

오류 코드 설명은 데이터셋 페이지의 오픈API 에러코드 안내를 기준으로 했어요. 같은 키라도 다른 데이터셋에는 따로 활용신청을 해야 해요.

자주 묻는 질문

승인까지 얼마나 걸리나요?

이 서비스는 자동승인으로 표시돼 있고, 직접 신청했을 때 제출 직후 승인 상태로 바뀌었어요. 다른 데이터셋은 심의유형이 다를 수 있으니 각 페이지를 확인하세요.

개발계정 트래픽이 부족하면 어떻게 하나요?

공식 페이지는 운영계정의 경우 활용사례를 등록하면 트래픽 증가를 신청할 수 있다고 안내해요.

직접 개발하지 않고 알림만 받을 수 있나요?

네. 누스 입찰알림에서 키워드만 적으면 같은 공식 API로 새 공고를 확인해 푸시로 알려 드려요. 원리는 나라장터 입찰공고 알림 받는 법에 정리했어요.

출처

새 입찰공고를 놓치지 마세요.

키워드만 적으면 나라장터 새 공고를 푸시로 알려 드려요.

무료로 알림 받기 →