3.5 KiB
3.5 KiB
🔑 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 폴백 시스템
1순위: 국토교통부 ITS API (process.env.ITS_API_KEY)
2순위: 한국도로공사 API (process.env.EXWAY_API_KEY)
3순위: 더미 데이터 (현실적인 예시)
연동 방법
# .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건의 알림
🚀 다음 단계
단기 (지금)
- 기상청 특보 API 연동 완료
- 한국은행 환율 API 연동 완료
- ITS/한국도로공사 API 키 발급 완료
- 다중 API 폴백 시스템 구축
- API 엔드포인트 URL 확인 (고객센터 문의)
중기 (API URL 확인 후)
- ITS API 연동 (즉시 가능)
- 한국도로공사 API 연동 (즉시 가능)
- 실시간 교통사고 데이터 표시
- 실시간 도로공사 데이터 표시
장기 (추가 기능)
- 서울시 TOPIS API 추가
- CCTV 화상 자료 연동
- 도로전광표지(VMS) 정보
- 교통예측정보
작성일: 2025-10-14 상태: 기상청 특보 작동 중, 교통정보 API URL 확인 필요