ADR-001 외부 연동 전환 판정 기준 = 무료 일 한도 1,000건 임계
- 상태: 채택
- 날짜: 2026-07-03
- 근거: PRD FR-2 / TDD “발급 주체 무료 API 전환 조사표”
맥락
env 스위치로 mock↔실연동 전환은 이미 가능하나, “어떤 API를 실연동으로 켤지”의 판정 기준이 수치화된 적 없다. 발급 주체별 무료 한도가 제각각(카카오 좌표변환 100k/day, 공공데이터포털 개발계정 10k/day, 에어코리아 500/day, SOLAPI 건당 과금)이라 일관 기준이 필요하다.
결정
무료 API 일일 요청 한도 ≥ 1,000건이면 실연동 전환, 미만이면 mock 유지 + 사유 기록.
판정 결과:
| 발급 주체 / 서비스 | 무료 일 한도 | 판정 |
|---|---|---|
| 카카오 Local REST 좌표변환 | 100,000 | 전환 |
| 공공데이터포털 기상청 단기예보 | 10,000 | 전환 |
| 공공데이터포털 공공체육시설 | 10,000 | 전환 (동일 키) |
| SOLAPI SMS | 한도 아님(건당 과금+발신번호) | mock 유지 |
근거
- 조사 대상 전환 후보의 무료 한도(10k~100k)가 임계를 크게 상회 → 판정이 견고(임계 민감도 낮음).
- 개발·정합성 검증 목적 저빈도 호출은 하루 수십~수백 건 수준 → 1,000건 임계면 충분한 여유.
- 대량 조회 트래픽은 상시 트래픽 시뮬레이터가 계속 mock 사용(PRD Non-Goals) → 실연동은 한도 압박 없음.
대안 (미채택)
- 한도 무관 전부 전환: SOLAPI·PG처럼 사업자 요건이 있는 항목까지 전환 시도 → 실현 불가·과금. 기각.
- 건당 과금까지 전환 허용: 무료 원칙(PRD) 위반. 기각.
영향
- FR-3: 공공데이터포털 키 1건 발급으로 facility·weather 동시 전환.
- 임계 적정성은 실 사용량 관측(옵저버빌리티 과제) 후 재조정(PRD Open Q2).