나라장터 상세조회 API 오류 기록 — 2026년 8월 실측과 목록 조회 대체 경로

※2026년 9월 7일 업데이트: 아래 오류는 2026년 8월 14일 당시의 호출 기록입니다. 이번 점검에서 해당 상세 API를 다시 호출하지 않았으므로 현재 장애·복구 여부를 뜻하지 않습니다. 현재 서비스 코드가 목록 조회 경로를 사용하는지는 확인했습니다.

나라장터 OpenAPI로 시스템을 연동해 쓰시는 분들께 드리는 실무 공유입니다. 저희가 겪은 것을 그대로 적습니다.

1.무슨 일이 있었나

당시 확인한 공고 상세조회 엔드포인트는 오류를 반환했습니다.

• getBidPblancDetailInfoCnstwk (공사)
• getBidPblancDetailInfoServc (용역)
• getBidPblancDetailInfoThng (물품)

세 개 모두 HTTP 400과 함께 NO_OPENAPI_SERVICE_ERROR(코드 12)를 돌려줍니다. 2026년 8월 14일 저희가 직접 호출해 확인한 결과입니다.

외자(Frgcpt)는 원래부터 상세 엔드포인트가 없어 해당 사항이 없습니다.

2.먼저 분명히 해둘 것

저희는 조달청의 공식 폐기 공지를 확인하지 못했습니다. 위 내용은 "공식 발표"가 아니라 "저희가 호출했더니 이렇게 응답하더라"는 실측입니다.

코드 12는 통상 등록되지 않은 서비스에 요청했을 때 나오는 응답입니다. 다만 그것이 폐기 때문인지, 계정별 신청 문제인지, 일시적인 것인지는 저희가 단정할 수 없습니다. 같은 증상을 겪고 계신 분이 있는지 궁금합니다.

3.대체 경로 — 목록 API의 단건 조회

목록 조회 엔드포인트에 조회구분과 공고번호를 넣으면 한 건만 가져올 수 있습니다.

getBidPblancListInfo{카테고리}

• inqryDiv=2
• bidNtceNo={공고번호}

이렇게 부르면 해당 공고 한 건이 정상 반환됩니다. 당시 조회한 응답을 대체 경로로 사용했습니다. 다만 글에 표본 수와 공고 유형별 검증 근거가 남아 있지 않은 ‘143개 필드가 같다’는 설명은 철회합니다. 목록 API가 모든 상세 전용 필드를 동일하게 제공한다고 단정할 수 없으며, 필요한 필드를 개별 확인해야 합니다.

카테고리는 공사·용역·물품을 차례로 시도해서 걸리는 것을 쓰면 됩니다. 공고번호만으로는 어느 카테고리인지 알 수 없기 때문입니다.

4.이게 왜 몇 달간 안 드러났는가 — 저희 잘못입니다

여기가 공유하고 싶은 진짜 이유입니다.

저희 코드는 응답이 실패면 조용히 다음 카테고리로 넘어가도록 돼 있었습니다. 카테고리를 잘못 짚는 건 정상적인 일이라 그렇게 만든 것인데, 그 결과 엔드포인트 자체가 죽은 것과 카테고리가 안 맞는 것이 똑같이 보였습니다.

세 카테고리를 다 시도하고 다 실패하면 "이 공고는 상세 정보가 없다"로 처리됐습니다. 오류도, 경고도 남지 않았습니다. 그동안 호출 한 번마다 헛요청을 세 번씩 보내고 있었습니다.

지금은 계정이나 서비스 자체가 막힌 것으로 보이는 응답은 반드시 로그에 남기도록 고쳤습니다.

연동하신 시스템이 있다면 한번 확인해보시길 권합니다. 실패를 조용히 넘기는 구조라면 이미 몇 달째 데이터가 비어 있을 수 있습니다.

5.정상인 것

낙찰 정보와 개찰 결과 API가 정상이라는 설명도 당시 사용 범위에서의 관찰입니다. 현재 전체 서비스의 정상 여부를 보장하는 실시간 상태 안내는 아닙니다.

출처

• 조달청 나라장터 공공데이터 OpenAPI 실제 호출 결과 (2026-08-14 확인)

같은 증상을 겪으셨거나, 공식 안내를 보신 분이 있으면 댓글로 알려주세요. 확인되면 이 글에 반영하겠습니다.