
# 🔑 API 키 현황 및 연동 상태

## ✅ 완벽 작동 중

### 1. 기상청 API Hub
- **API 키**: `${KMA_API_KEY}`
- **상태**: ✅ 14건 실시간 특보 수신 중
- **제공 데이터**: 대설/강풍/한파/태풍/폭염 특보
- **코드 위치**: `backend-node/src/services/riskAlertService.ts`

### 2. 한국은행 환율 API
- **API 키**: `${BOK_API_KEY}`
- **상태**: ✅ 환율 위젯 작동 중
- **제공 데이터**: USD/EUR/JPY/CNY 환율

---

## ⚠️ 연동 대기 중

### 3. 한국도로공사 OpenOASIS API
- **API 키**: `${EXWAY_API_KEY}`
- **상태**: ❌ 엔드포인트 URL 불명
- **문제**: 
  - 발급 이메일에 사용법 없음
  - 매뉴얼에 상세 정보 없음
  - 테스트한 URL 모두 실패

**해결 방법**:
```
📞 한국도로공사 고객센터 문의

컨텐츠 문의: 054-811-4533
시스템 장애: 070-8656-8771

문의 내용:
"OpenOASIS API 인증키(${EXWAY_API_KEY})를 발급받았는데
 사용 방법과 엔드포인트 URL을 알려주세요.
 - 돌발상황정보 API
 - 교통사고 정보
 - 도로공사 정보"
```

### 4. 국토교통부 ITS API
- **API 키**: `${ITS_API_KEY}`
- **상태**: ❌ 엔드포인트 URL 불명
- **승인 API**: 
  - 교통소통정보
  - 돌발상황정보
  - CCTV 화상자료
  - 교통예측정보
  - 차량검지정보
  - 도로전광표지(VMS)
  - 주의운전구간
  - 가변형 속도제한표지(VSL)
  - 위험물질 운송차량 사고정보

**해결 방법**:
```
📞 ITS 국가교통정보센터 문의

전화: 1577-6782
이메일: its@ex.co.kr

문의 내용:
"ITS API 인증키(${ITS_API_KEY})를
 발급받았는데 매뉴얼에 엔드포인트 URL이 없습니다.
 돌발상황정보 API의 정확한 URL과 파라미터를
 알려주세요."
```

---

## 🔧 백엔드 연동 준비 완료

### 파일 위치
- **서비스**: `backend-node/src/services/riskAlertService.ts`
- **컨트롤러**: `backend-node/src/controllers/riskAlertController.ts`
- **라우트**: `backend-node/src/routes/riskAlertRoutes.ts`

### 다중 API 폴백 시스템
```typescript
1순위: 국토교통부 ITS API (process.env.ITS_API_KEY)
2순위: 한국도로공사 API (process.env.EXWAY_API_KEY)
3순위: 더미 데이터 (현실적인 예시)
```

### 연동 방법
```bash
# .env 파일에 추가
ITS_API_KEY=${ITS_API_KEY}
EXWAY_API_KEY=${EXWAY_API_KEY}

# 백엔드 재시작
docker restart pms-backend-mac

# 로그 확인
docker logs pms-backend-mac --tail 50
```

---

## 📊 현재 리스크/알림 시스템

```
✅ 기상특보: 14건 (실시간 기상청 데이터)
⚠️ 교통사고: 2건 (더미 데이터)
⚠️ 도로공사: 2건 (더미 데이터)
────────────────────────────
총 18건의 알림
```

---

## 🚀 다음 단계

### 단기 (지금)
- [x] 기상청 특보 API 연동 완료
- [x] 한국은행 환율 API 연동 완료
- [x] ITS/한국도로공사 API 키 발급 완료
- [x] 다중 API 폴백 시스템 구축
- [ ] **API 엔드포인트 URL 확인 (고객센터 문의)**

### 중기 (API URL 확인 후)
- [ ] ITS API 연동 (즉시 가능)
- [ ] 한국도로공사 API 연동 (즉시 가능)
- [ ] 실시간 교통사고 데이터 표시
- [ ] 실시간 도로공사 데이터 표시

### 장기 (추가 기능)
- [ ] 서울시 TOPIS API 추가
- [ ] CCTV 화상 자료 연동
- [ ] 도로전광표지(VMS) 정보
- [ ] 교통예측정보

---

**작성일**: 2025-10-14
**상태**: 기상청 특보 작동 중, 교통정보 API URL 확인 필요

