사용하는 데이터 종류
| 종류 | 기준 | 주요 사용처 |
|---|---|---|
| 은행 최신 환율 | KRW 기준 은행 고시 | 매매기준율, 현찰·송금, 은행 비교 |
| 은행 전일 환율 | 같은 은행의 이전 고시일 | 동일 출처의 전일 등락 비교 |
| 글로벌 최신 환율 | USD 기준 일일 환율 | 전체 통화 목록과 글로벌 교차환율 |
| 글로벌 전일 환율 | 같은 글로벌 계열의 이전 데이터일 | 전체 지원 통화의 전일 등락 |
| 통화별 이력 | 제공 가능한 기간별 관측값 | 7·30·365일 환율 추이 |
수집과 검증 과정
- 빌드 과정에서 외부 API 응답을 데이터 스키마로 검증하고 UI용 정규화 모델로 변환합니다.
- 통화코드, 갱신시각, 고시 단위와 핵심 환율 필드가 예상 형식인지 확인합니다.
- 누락되거나 0 이하인 환율과 계산할 수 없는 숫자는 사용 가능 값에서 제외합니다.
- 핵심 데이터 누락이나 스키마 오류가 발생하면 운영 빌드를 실패시켜 기존 정상 배포를 유지합니다.
- 검증 결과와 수집 건수는 빌드 데이터 건강 보고서에 기록합니다.
정적 스냅샷과 브라우저 갱신
정적 사이트는 빌드 시점의 검증된 환율을 HTML에 포함합니다. 따라서 JavaScript가 꺼져 있거나 최신 데이터 요청이 일시적으로 실패해도 마지막 정상 환율과 핵심 설명을 읽을 수 있습니다.
브라우저에서는 최신 환율 데이터를 별도로 확인합니다. 원격 데이터가 정적 스냅샷보다 새롭고 스키마와 값 검증을 모두 통과할 때만 숫자와 기준정보를 갱신합니다. 오래됐거나 비정상인 응답은 화면을 덮어쓰지 않습니다.
랜딩 환율의 대표값 선택
원화 기준 목록은 통화별로 사용할 수 있는 하나은행, KB국민은행, 글로벌 값을 비교해 가장 최신 갱신시각의 값을 대표 환율로 선택합니다. 갱신시각이 같다면 하나은행, KB국민은행, 글로벌 순으로 선택합니다.
등락률 역시 대표 환율과 같은 출처의 전일값을 우선 사용합니다. USD 기준 보기에서는 서로 일관된 교차계산을 위해 글로벌 데이터만 사용합니다.
데이터 이용 시 알아둘 점
- GetFXRate는 외부에서 제공된 환율 데이터를 재계산·표시하며 각 은행의 공식 거래 화면을 대체하지 않습니다.
- 데이터 제공 지연, 휴일, 고시회차와 시장 마감시간 때문에 서로 다른 기준일이 표시될 수 있습니다.
- 과거 데이터는 제공 범위와 통화에 따라 기간이나 관측점 수가 다를 수 있습니다.
- 실제 체결 환율에는 고객별 우대, 채널, 수수료와 은행 반올림 규칙이 추가될 수 있습니다.