[나라장터 입찰공고 검색기 #2] 코드 짜기 전 필수 관문! 공공데이터포털 API 테스트 가이드

오늘은 공공데이터포털 API 테스트를 해볼거에요. 지난 포스팅에서 나라장터 API 활용 신청까지 무사히 마치셨을 겁니다. 이제 바로 파이썬 코드를 짤 것 같지만, 그전에 꼭 거쳐야 할 과정이 있습니다. 바로 공공데이터포털에서 제공하는 테스트 도구로 데이터를 미리 확인하는 것입니다. 우리는 지금 AI를 비서로 활용하는 ‘바이브 코딩’을 하고 있죠? AI에게 무작정 “나라장터 공고 가져오는 코드 짜줘”라고 하면 AI는 범용적인 […]

오늘은 공공데이터포털 API 테스트를 해볼거에요. 지난 포스팅에서 나라장터 API 활용 신청까지 무사히 마치셨을 겁니다. 이제 바로 파이썬 코드를 짤 것 같지만, 그전에 꼭 거쳐야 할 과정이 있습니다. 바로 공공데이터포털에서 제공하는 테스트 도구로 데이터를 미리 확인하는 것입니다.

우리는 지금 AI를 비서로 활용하는 ‘바이브 코딩’을 하고 있죠? AI에게 무작정 “나라장터 공고 가져오는 코드 짜줘”라고 하면 AI는 범용적인 코드만 줍니다. 하지만 “실제 API 호출 결과는 이런 구조(JSON/XML)이고, 이런 파라미터가 들어가. 이걸 바탕으로 코드를 짜줘”라고 구체적인 정보를 던져주면, 단 한 번에 완벽한 결과물을 얻을 수 있습니다.

비서(AI)에게 정확한 레시피를 주기 위해, 우리가 먼저 재료를 확인해 보는 시간이라고 생각하시면 됩니다.

✅이 포스팅이 처음이면 지난 포스팅을 보고 API 발급부터 받으세요

[나라장터 입찰공고 검색기 #1] 공공데이터 포털 API 신청 및 인증키 발급 가이드

1. 공공데이터포털 API 테스트

STEP 1: 서비스 상세 페이지 접속 및 인증키 복사

먼저 공공데이터포털 마이페이지에서 활용 신청한 “조달청_나라장터 입찰공고정보서비스”를 클릭해 들어갑니다. 화면 중간에 보이는 Encoding 키와 Decoding 키를 미리 메모장에 복사해 두세요.

STEP 2: 상세설명 및 API 목록 확인

화면 상단이나 중간에 있는 [상세설명] 혹은 바로 아래의 API 목록 섹션을 확인합니다. 나라장터 API는 공사, 용역, 물품 등 종류가 매우 다양합니다.

우리는 이번 테스트에서 가장 범용적인 “나라장터검색조건에 의한 입찰공고용역조회”를 선택해 보겠습니다. 해당 항목을 클릭한 뒤, 우측의 [openAPI 실행준비] 버튼을 눌러주세요.

STEP 3: 파라미터(Parameter) 입력 및 호출

이제 데이터를 불러오기 위한 세부 조건을 입력할 차례입니다. 빨간색 별표(*)가 붙은 항목은 필수값이니 반드시 채워야 합니다.

serviceKey: 발급받은 인증키 중 ‘Decoding 키’를 입력합니다. (Encoding 키를 넣으면 401 에러가 날 확률이 높으니 주의하세요!)
pageNo / numOfRows: 각각 1과 10 정도로 설정합니다.
inqryDiv (조회구분): 보통 1(공고일 기준)을 입력합니다.
inqryBgnDt / inqryEndDt: 조회할 날짜 범위를 YYYYMMDDHHMM 형식으로 입력합니다. (예: 202604280000)

입력을 마쳤다면 스크롤을 내려 [openAPI 호출] 버튼을 클릭합니다.

3. 테스트 결과 확인: 성공의 기쁨!

잠시 기다리면 하단 Responses 영역에 데이터가 쏟아져 나옵니다. 200 OK 메시지와 함께 <items> 태그 안에 실제 입찰 공고 제목, URL, 기관명 등이 깔끔하게 보인다면 성공입니다!

처음 보는 복잡한 코드처럼 보일 수 있지만 괜찮습니다. 우리는 이 내용을 이해할 필요가 없습니다. 이 결과 화면 전체를 복사해서 나중에 AI에게 전달해주기만 하면 되거든요.

4. 삽질 방지 팁: 인증 에러가 난다면?

만약 결과가 나오지 않고 에러가 발생한다면 다음 두 가지만 확인해 보세요.

인증키 반영 시간: 승인 직후에는 서버 반영까지 시간이 걸릴 수 있습니다. 1시간 뒤에 다시 시도해 보세요.
키 종류: Encoding 키 대신 꼭 Decoding 키를 사용했는지 확인하세요.

맺으며: 이제 진짜 코딩할 시간입니다

오늘은 인증받은 API 키가 실제로 작동하는지 공공데이터포털에서 직접 검증해 봤습니다. 데이터가 잘 들어오는 것을 확인했으니, 이제 AI에게 가장 정확한 명령을 내릴 준비가 끝난 셈입니다.

다음 포스팅에서는 오늘 얻은 테스트 결과물과 파라미터 정보를 제미나이에게 던져주고, 단 1분 만에 동작하는 검색기 코드를 완성해 보겠습니다. 과연 AI가 얼마나 똑똑하게 코드를 짜줄지 기대해 주세요!

[나라장터 입찰공고 검색기 #1] 공공데이터 포털 API 신청 및 인증키 발급 가이드