vexplor/backend-node/README_API_SETUP.md

🔑 API 키 설정 가이드

빠른 시작 (신규 팀원용)

1. API 키 파일 복사

cd backend-node
cp .env.shared .env

2. 끝!

• .env.shared 파일에 팀 공유 API 키가 이미 들어있습니다
• 그대로 복사해서 사용하면 됩니다
• 추가 발급 필요 없음!

---

📋 포함된 API 키

✅ 한국은행 환율 API

• 용도: 환율 정보 조회
• 키: OXIGPQXH68NUKVKL5KT9

✅ 기상청 API Hub

• 용도: 날씨특보, 기상정보
• 키: ogdXr2e9T4iHV69nvV-IwA

✅ ITS 국가교통정보센터

• 용도: 교통사고, 도로공사 정보
• 키: d6b9befec3114d648284674b8fddcc32

✅ 한국도로공사 OpenOASIS

• 용도: 고속도로 교통정보
• 키: 7820214492

---

⚠️ 주의사항

Git 관리

✅ .env.shared  → Git에 커밋됨 (팀 공유용)
❌ .env         → Git에 커밋 안 됨 (개인 설정)

보안

• 팀 내부 프로젝트이므로 키 공유가 안전합니다
• 외부 공개 프로젝트라면 각자 발급받아야 합니다

---

🚀 서버 시작

# 1. API 키 설정 (최초 1회만)
cp .env.shared .env

# 2. 서버 시작
npm run dev

# 또는 Docker
docker-compose up -d

---

💡 트러블슈팅

.env 파일이 없다는 오류

# 해결: .env.shared를 복사
cp .env.shared .env

API 호출이 실패함

# 1. .env 파일 확인
cat .env

# 2. API 키가 제대로 복사되었는지 확인
# 3. 서버 재시작
npm run dev

---

팀원 여러분, .env.shared를 복사해서 사용하세요! 👍