Aislo/resources/knowledge/.secrets.local.md

API 인증키 (로컬 전용 — 커밋 금지)

이 파일은 .gitignore에 등록되어 있다. 원격에 push 되지 않는다. 키는 개인 발급분이며 유효기간이 있다. 만료 시 각 기관에서 재발급 후 아래를 갱신한다.

국가건설기준센터 (KCSC)

• 용도: 표준시방서(KCS) 본문 수집 — kcsc.re.kr/OpenApi/CodeViewer, /CodeList
• 인증키: V86LjYzYe237yK1lFjhYXCgOe8H9AtzIJ5xoxQ2O3yg
• 발급 계정: umsangdon
• 유효기간: 2026-08-09 20:09 ~ 2027-08-09 20:09 (1년)
• 사용법: https://kcsc.re.kr/OpenApi/CodeViewer/KCS/<코드>?key=<키> (path 방식, 소문자 key)
• 발급/재발급: kcsc.re.kr 로그인 → 마이페이지 API Key

국가법령정보센터 (law.go.kr)

• 용도: 법령·행정규칙 원문 — law.go.kr/DRF/lawSearch.do, lawService.do
• OC 키: umsangdon (이메일 ID = OC 값, 별도 만료 없음)
• 사용법: ?OC=umsangdon&target=law&...

공공데이터포털 (data.go.kr) — 일반 인증키

• 용도: 조달청 나라장터 가격정보현황서비스 등 data.go.kr OpenAPI 전반 (API별 활용신청 필요)
• 인증키(Encoding형, URL에 그대로 사용): 0j5WZHeNxSkdPVSLXUsx9kVikXEN%2BDc%2Byv68jz8IpKFffjbZkRiQrJO78y6rxPCTqhiSOW4lDxpid0twkSVQ9g%3D%3D
• 발급: 2026-08-14, 계정 = data.go.kr 회원(사용자 개인). 만료 시 마이페이지 → 오픈API → 개발계정에서 갱신
• 검증(2026-08-14): 가격정보현황서비스 실호출 정상 (resultCode 00)
  • 엔드포인트: http://apis.data.go.kr/1230000/ao/PriceInfoService/<오퍼레이션>?serviceKey=<키>&pageNo=1&numOfRows=999&type=json
  • 오퍼레이션: getPriceInfoListFcltyCmmnMtril{Engrk|Bildng|MchnEqp|ElctyIrmc|Total}(시설공통자재 토목/건축/기계설비/전기정보통신/종합), getPriceInfoListMrktCnstrctPc{...}(시장시공가격), getCnsttyClsfcInfoList, getNetRsceinfoList, getStdMarkUprcinfoList(표준시장단가 — 호출 방법 미해결, HTTP_ERROR 04)
  • 데이터 범위 실측: 시설공통자재 4분야 27,485건, 고시일 2024-10~2026-04. ⚠ 철근·레미콘·아스콘·시멘트 미포함 — 주요 관급자재는 아래 종합쇼핑몰 서비스 사용
• 종합쇼핑몰 품목정보 서비스 (활용신청·검증 2026-08-14, 같은 키):
  • 엔드포인트: https://apis.data.go.kr/1230000/at/ShoppingMallPrdctInfoService/<오퍼레이션>?serviceKey=<키>&type=json&inqryDiv=2&prdctClsfcNoNm=<품명> (inqryDiv=1은 등록일 기간 조회)
  • 오퍼레이션: getMASCntrctPrdctInfoList(다수공급자 — 레미콘 26,412건·시멘트 8건), getUcntrctPrdctInfoList(일반단가 — 아스팔트콘크리트 17건·조합공통품목), getThptyUcntrctPrdctInfoList(3자단가 — 아스팔트콘크리트 13건), 납품요구 getDlvrReqInfoList 등
  • 실측 예: 레미콘 25-18-120 = 91,580원(경기중부조합) · 시멘트 40kg포 = 5,820원(쌍용 — 울진 실무 내역 조달가와 정확히 일치) · 아스팔트콘크리트 WC-2 = 140,920원
  • ⚠ 검색 팁: 품명은 정식 분류명 — "아스콘"→"아스팔트콘크리트", 철근은 "철근" 검색 시 암거블록 등 혼입(분류 정제 필요)

오피넷 (opinet.co.kr) — 유가 무료 API

• 용도: 유류 단가 (중기 기초자료 — 견적 엔진)
• 무료 Key: F260814125 (발급 2026-08-14, 사용자 계정)
• 사용법: https://www.opinet.co.kr/api/<오퍼레이션>?out=json&code=<키> (out=xml 가능)
• 검증(2026-08-14): avgAllPrice.do(전국 일별 평균 — 고급휘발유 B034/휘발유 B027/자동차용경유 D047/실내등유 C004/부탄 K015), avgRecentPrice.do?prodcd=D047(최근 7일 일별), avgSidoPrice.do(시도별) 실호출 정상
• ⚠ 선박용경유·중유(벙커C)·대리점 판매가는 무료 API 미포함 — 필요 시 웹표 opinet.co.kr/user/dopavsel/dopAvselSelect.do 스크래핑 (임도·사방 건설기계 연료는 경유 위주라 실무 영향 낮음. 2026-08-14 사용자 결정: 선박용경유 불요, 필요 시 재요청)

한국은행 ECOS (ecos.bok.or.kr) — 환율 API

• 용도: 환율 매매기준율·재정환율 (중기 기초자료 — 기계경비 외화 환산)
• 인증키: 0QUDJ05SXNFFD1T4XQUZ (발급 2026-08-14, 사용자 계정. ecos.bok.or.kr/api 마이페이지에서 관리)
• 사용법: https://ecos.bok.or.kr/api/StatisticSearch/<키>/json/kr/1/100/731Y001/D/<시작일>/<종료일>/<항목코드>
• 통계표 731Y001 "주요국 통화의 대원화환율" (일별) — 항목코드 (2026-08-14 실조회):
  • 0000001 원/미국달러(매매기준율) · 0000002 원/일본엔(100엔) · 0000003 원/유로 · 0000012 원/영국파운드 · 0000053 원/위안(매매기준율)
  • USD·위안만 공식 매매기준율, 엔·유로·파운드는 재정환율 — ESTX 기계경비 환율 5통화($·¥100·€·£·M) 중 마르크 제외 전부 커버
• 검증(2026-08-14): USD 일별 5영업일 실호출 정상 (08-14 = 1,414.9원). 값은 서울외국환중개 고시와 동일 원천