건축물대장 API 라이브 통합 테스트 리포트

검증 주소 대전 유성구 가정동 277 — 도룡포레미소지움 · 실측 2026-05-19 · 6/6 PASS · 3.54s

요약

공공데이터포털 건축물대장(1613000 BldRgstHubService) 5종 엔드포인트를 실서버 호출로 검증한다. 메일 리포트(2026-05-18, daejeon-bld-report)에서 보고된 totalCount 와 5종 모두 정확히 일치했고, 표제부 첫 행 페이로드 필수 필드도 채워져 있음을 확인했다.

JUSO 개발키(devU01TX0FVVEgyMDI1...) 는 errorCode=E0014(인증키 만료/오용) 가 발생해 본 테스트는 자동으로 Kakao Local API b_code 우회 경로를 사용했다. 이는 메일 리포트가 채택한 동일한 회피 패턴이다.

5종 엔드포인트 결과

이름 path 메일 기준 실측 일치
표제부 getBrTitleInfo 9 9 ✓
총괄표제부 getBrRecapTitleInfo 1 1 ✓
층별개요 getBrFlrOulnInfo 98 98 ✓
전유공용면적 getBrExposPubuseAreaInfo 1,630 1,630 ✓
주택가격 getBrHsprcInfo 1,160 1,160 ✓

표제부 첫 행 페이로드

주용도 (mainPurpsCdNm)
공동주택
연면적 (totArea)
5,301.0259 ㎡
지상층수 (grndFlrCnt)
12 F

주소 변환 폴백 체인

1
JUSO confmKey business.juso.go.kr/addrlink/addrLinkApi.do · 응답 results.common.errorCode == "0" 일 때만 사용 · admCd 10자리 → sigunguCd(5) + bjdongCd(5), lnbrMnnm/lnbrSlno → bun/ji zfill(4)
2
Kakao Local API b_code (현재 활성) dapi.kakao.com/v2/local/search/address.json · Authorization: KakaoAK <KAKAO_API_KEY> · documents[0].address.b_code 10자리 동일 규칙 + main_address_no/sub_address_no

환경변수 매트릭스

키역할출처현재 상태
BLDRGST_API_KEY data.go.kr serviceKey Infisical alpha · /ai-real-estate-backend 설정
DATA_GO_KR_API_KEY 위와 동일 (별칭, 코드 어댑터가 이쪽 명칭 사용) Infisical alpha 설정
JUSO_API_KEY 도로명주소 confmKey Infisical alpha (현재 dev* 키) E0014 만료
KAKAO_API_KEY Kakao Local REST — JUSO 폴백 경로 Infisical alpha 설정

실행

cd backend
.venv/bin/pytest tests/integration/external/test_building_registry_live.py -v -s --no-cov

테스트는 backend/tests/integration/external/test_building_registry_live.py. pytest mark integration + asyncio. 키 미설정 시 자동 skip.

공식문서