53 lines
5.0 KiB
Markdown
53 lines
5.0 KiB
Markdown
# 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원). 값은 서울외국환중개 고시와 동일 원천
|