# 🔑 API 키 설정 가이드

## 빠른 시작 (신규 팀원용)

### 1. API 키 파일 복사
```bash
cd backend-node
cp .env.shared .env
```

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

---

## 📋 포함된 API 키

### ✅ 한국은행 환율 API
- 용도: 환율 정보 조회
- 키: `OXIGPQXH68NUKVKL5KT9`

### ✅ 기상청 API Hub
- 용도: 날씨특보, 기상정보
- 키: `ogdXr2e9T4iHV69nvV-IwA`

### ✅ ITS 국가교통정보센터
- 용도: 교통사고, 도로공사 정보
- 키: `d6b9befec3114d648284674b8fddcc32`

### ✅ 한국도로공사 OpenOASIS
- 용도: 고속도로 교통정보
- 키: `7820214492`

---

## ⚠️ 주의사항

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

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

---

## 🚀 서버 시작

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

# 2. 서버 시작
npm run dev

# 또는 Docker
docker-compose up -d
```

---

## 💡 트러블슈팅

### `.env` 파일이 없다는 오류
```bash
# 해결: .env.shared를 복사
cp .env.shared .env
```

### API 호출이 실패함
```bash
# 1. .env 파일 확인
cat .env

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

---

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