141 lines
3.5 KiB
Markdown
141 lines
3.5 KiB
Markdown
|
|
||
|
|
# 🔑 API 키 현황 및 연동 상태
|
||
|
|
|
||
|
|
## ✅ 완벽 작동 중
|
||
|
|
|
||
|
|
### 1. 기상청 API Hub
|
||
|
|
- **API 키**: `ogdXr2e9T4iHV69nvV-IwA`
|
||
|
|
- **상태**: ✅ 14건 실시간 특보 수신 중
|
||
|
|
- **제공 데이터**: 대설/강풍/한파/태풍/폭염 특보
|
||
|
|
- **코드 위치**: `backend-node/src/services/riskAlertService.ts`
|
||
|
|
|
||
|
|
### 2. 한국은행 환율 API
|
||
|
|
- **API 키**: `OXIGPQXH68NUKVKL5KT9`
|
||
|
|
- **상태**: ✅ 환율 위젯 작동 중
|
||
|
|
- **제공 데이터**: USD/EUR/JPY/CNY 환율
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## ⚠️ 연동 대기 중
|
||
|
|
|
||
|
|
### 3. 한국도로공사 OpenOASIS API
|
||
|
|
- **API 키**: `7820214492`
|
||
|
|
- **상태**: ❌ 엔드포인트 URL 불명
|
||
|
|
- **문제**:
|
||
|
|
- 발급 이메일에 사용법 없음
|
||
|
|
- 매뉴얼에 상세 정보 없음
|
||
|
|
- 테스트한 URL 모두 실패
|
||
|
|
|
||
|
|
**해결 방법**:
|
||
|
|
```
|
||
|
|
📞 한국도로공사 고객센터 문의
|
||
|
|
|
||
|
|
컨텐츠 문의: 054-811-4533
|
||
|
|
시스템 장애: 070-8656-8771
|
||
|
|
|
||
|
|
문의 내용:
|
||
|
|
"OpenOASIS API 인증키(7820214492)를 발급받았는데
|
||
|
|
사용 방법과 엔드포인트 URL을 알려주세요.
|
||
|
|
- 돌발상황정보 API
|
||
|
|
- 교통사고 정보
|
||
|
|
- 도로공사 정보"
|
||
|
|
```
|
||
|
|
|
||
|
|
### 4. 국토교통부 ITS API
|
||
|
|
- **API 키**: `d6b9befec3114d648284674b8fddcc32`
|
||
|
|
- **상태**: ❌ 엔드포인트 URL 불명
|
||
|
|
- **승인 API**:
|
||
|
|
- 교통소통정보
|
||
|
|
- 돌발상황정보
|
||
|
|
- CCTV 화상자료
|
||
|
|
- 교통예측정보
|
||
|
|
- 차량검지정보
|
||
|
|
- 도로전광표지(VMS)
|
||
|
|
- 주의운전구간
|
||
|
|
- 가변형 속도제한표지(VSL)
|
||
|
|
- 위험물질 운송차량 사고정보
|
||
|
|
|
||
|
|
**해결 방법**:
|
||
|
|
```
|
||
|
|
📞 ITS 국가교통정보센터 문의
|
||
|
|
|
||
|
|
전화: 1577-6782
|
||
|
|
이메일: its@ex.co.kr
|
||
|
|
|
||
|
|
문의 내용:
|
||
|
|
"ITS API 인증키(d6b9befec3114d648284674b8fddcc32)를
|
||
|
|
발급받았는데 매뉴얼에 엔드포인트 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=d6b9befec3114d648284674b8fddcc32
|
||
|
|
EXWAY_API_KEY=7820214492
|
||
|
|
|
||
|
|
# 백엔드 재시작
|
||
|
|
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 확인 필요
|
||
|
|
|