# BankAPI

> 한국 은행 계좌조회 REST API. 스타트업과 소상공인에게 월 3,000건 무료 제공.

## 핵심 정보

- **서비스**: 한국 은행 거래내역 및 잔액 조회 API
- **대상**: 스타트업, 소상공인, 개발자, 사이드 프로젝트
- **무료 플랜**: 월 3,000건 요청, 계좌 5개, 10건/분
- **인증**: API Key + Secret Key (Bearer Token)
- **응답 시간**: 10-30초 (은행 서버 특성)
- **지원 은행**: 농협, 국민, 신한, 우리, 하나, 카카오뱅크, 토스뱅크 등 12개 은행

## 프로젝트 목적

BankAPI는 **수익이 아닌 기술 공유**를 목적으로 합니다.

한국 금융 API 생태계가 제한적인 상황에서, 스타트업과 소상공인이 계좌조회 기능을 부담 없이 사용할 수 있도록 무료로 제공합니다.

## 기술 스택

- Firebase Functions (인증, Rate Limiting)
- Google Cloud Run + Puppeteer (크롤링)
- Firestore (데이터베이스)
- SHA256 해시 암호화
- HTTPS 필수

## 시작하기

### 1. 회원가입 (https://bankapi.co.kr/signup)
1. 이메일 입력
2. 인증코드 확인 (6자리, 5분 유효)
3. API Key + Secret Key 발급

### 2. API 호출

```
POST https://api-7mpyj62y4a-du.a.run.app/api/v1/transactions
Authorization: Bearer {apiKey}:{secretKey}

{
  "bankCode": "NH",
  "accountNumber": "123456789012"
}
```

**응답**: 거래내역 배열 (날짜, 금액, 잔액, 설명)

## 사용 대상

- ✅ 스타트업 및 소상공인의 실제 서비스
- ✅ 개인 프로젝트 및 사이드 프로젝트
- ✅ 교육 및 기술 연구 목적

## 지원 은행

농협, 국민, 신한, 우리, 하나, 기업, SC제일, 케이뱅크, 카카오뱅크, 토스뱅크, 새마을금고, 신협

## 링크

- **회원가입**: https://bankapi.co.kr/signup
- **API 문서**: https://bankapi.co.kr/docs
- **API 테스트**: https://bankapi.co.kr/api-test (회원가입 없이 체험)
- **문의**: bankapidev@gmail.com
- **카카오톡**: https://open.kakao.com/o/sflLmBai