공공데이터포털의 나라장터 API로 입찰공고(용역)를 조회하는 주소(URL)를 만들어 봅니다. 아래 칸을 채우고 복사를 누른 뒤, 인터넷 창 주소창에 붙여 넣으면 결과를 볼 수 있습니다.
※ 이 페이지에서는 조회하지 않습니다(인증키 보안). 복사한 주소를 새 탭 주소창에 붙여 넣고 Enter를 누르세요.
| 이름 | 뜻 | 값 |
|---|---|---|
serviceKey 필수 | 공공데이터포털에서 받은 인증키 마이페이지 → 활용신청 현황 → 일반 인증키(Encoding) |
|
pageNo | 몇 번째 페이지 | 1 |
numOfRows | 한 번에 가져올 건수 | 5 |
type | 결과 형식 (json / xml) | json |
inqryDiv | 조회 구분 (1 = 공고 게시일시로 찾기) | 1 |
inqryBgnDt | 조회 시작일시 (년월일시분 12자리) 오늘 포함 7일 전으로 자동 설정 |
|
inqryEndDt | 조회 종료일시 (년월일시분 12자리) 오늘로 자동 설정 · 기간은 최대 7일 |
|
bidNtceNm | 공고명 키워드 (비우면 전체) |
resultCode 가 "00", items 안에 공고가 보이면 성공입니다. (아래 값은 모양을 보여 주기 위한 예시입니다)
{
"response": {
"header": { "resultCode": "00", "resultMsg": "정상" },
"body": {
"items": [
{
"bidNtceNo": "R25BK00000000",
"bidNtceNm": "○○시 정보시스템 유지보수 용역",
"ntceInsttNm": "○○시",
"dminsttNm": "○○시 정보통신과",
"bidNtceDt": "2026-11-20 10:00:00",
"bidClseDt": "2026-11-28 10:00:00",
"bidNtceDtlUrl": "https://www.g2b.go.kr/..."
}
],
"numOfRows": 5, "pageNo": 1, "totalCount": 37
}
}
}
| 항목 | 뜻 |
|---|---|
bidNtceNm | 공고명 |
ntceInsttNm | 공고 기관 |
dminsttNm | 수요 기관 |
bidNtceDt | 공고 일시 |
bidClseDt | 입찰 마감일시 |
bidNtceDtlUrl | 나라장터 원문 주소 (주소창에 붙여 넣으면 공고가 열림) |
totalCount | 조건에 맞는 전체 공고 수 |
| 화면에 나온 것 | 뜻 · 할 일 |
|---|---|
SERVICE_KEY_IS_NOT_REGISTERED_ERROR (30) | 키가 아직 등록 전. 신청 직후면 1~2시간 뒤 다시. 계속되면 Decoding 키로 바꿔 보기 |
NO_OPENAPI_SERVICE_ERROR (12) | 주소 오타. 주소를 고치지 말고 이 페이지에서 다시 복사 |
| resultCode "00" 인데 totalCount 0 | 조건에 맞는 공고 없음. 키워드를 넓히기 |
{
"OpenAPI_ServiceResponse": {
"cmmMsgHeader": {
"errMsg": "SERVICE_KEY_IS_NOT_REGISTERED_ERROR",
"returnAuthMsg": "등록되지 않은 서비스키",
"returnReasonCode": "30"
}
}
}