kjs
/
ERP-node
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ERP-node/backend-node/API_키_정리.md

3.5 KiB
Raw Blame History

🔑 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 확인 필요