- 공식 사이트: https://ecos.bok.or.kr/api/
- 발급 키:
ECOS_API_KEY - Last Verified: 2026-06-10 (ecos 스킬 GUIDE에서 이전 — 실화면 재검증 시 갱신)
1. 가입 조건
- ECOS 일반 회원가입으로 충분합니다 (비용 없음).
- 인증키는 신청 즉시 발급됩니다 (별도 승인 대기 없음).
2. 발급 절차
- ecos.bok.or.kr/api 접속 → 회원가입 후 로그인
- Open API → 인증키 신청 → 사용 목적·서비스명 입력 후 제출 → 즉시 발급
- 발급된 인증키 복사
3. 키 ↔ 환경변수 매핑
| 항목 | 환경변수 |
|---|---|
| ECOS 인증키 | ECOS_API_KEY |
ECOS_API_KEY=발급받은_키4. 한도·주의사항
- 즉시 발급되지만 첫 호출 시 수 분간 일시적으로 미반영될 수 있습니다 — 잠시 후 다시 시도하세요.
- “API 키가 없다”는 안내(
INFO-100)는 키가 비어 있거나 등록 위치가 잘못된 경우입니다. - 너무 긴 기간·세밀한 주기를 한 번에 조회하면 타임아웃될 수 있습니다 — 3~5년 단위로 나눠 조회합니다.