한국수출입은행 현재환율 API가 갑자기 값을 안 준다면 결과코드부터 보면 됩니다. 주소 변경, 키 파기, 호출 한도, 업데이트 시각 가운데 어디서 막혔는지 결과코드와 공지로 가릴 수 있게 정리했습니다.
한국수출입은행 현재환율 API가 갑자기 값을 안 준다면 결과코드부터 보면 됩니다. 주소 변경, 키 파기, 호출 한도, 업데이트 시각 가운데 어디서 막혔는지 결과코드와 공지로 가릴 수 있게 정리했습니다.
한국수출입은행 API 요청 주소 변경
한국수출입은행은 2025년 6월 25일 API 요청 주소의 도메인을 www.koreaexim.go.kr에서 oapi.koreaexim.go.kr로 바꿨고, 2026년 4월 30일 기존 도메인 병행 가동을 중단했습니다. 현재환율 API 주소는 https://oapi.koreaexim.go.kr/site/program/financial/exchangeJSON 입니다. 방화벽을 열어야 하는 회사라면 홈페이지(39.115.136.135)와 API 호출(39.115.136.167) IP가 다르다는 점도 챙겨야 합니다.
한국수출입은행 API 결과코드
응답의 result 값이 원인입니다.
| result | 뜻 |
|---|---|
| 1 | 성공 |
| 2 | DATA코드 오류(data 값 확인) |
| 3 | 인증코드 오류 |
| 4 | 일일 제한횟수(1000회) 마감 |
| 값 null | 비영업일 또는 당일 11시 이전 요청 |
| 담당 | 정보시스템부 02-3779-6549 |
한국수출입은행 API 인증키 파기
멀쩡히 쓰던 키에서 result 3이 나오면 키가 파기됐을 가능성이 큽니다. 처음 신청할 때 넣은 개인정보의 보유기간 2년이 지나면 개인정보와 사용정보가 파기되고, 파기 전에 등록 이메일로 재동의 안내가 갑니다. 재동의하면 2년이 연장되지만, 이미 파기된 키는 다시 쓸 수 없어 새로 발급받아야 합니다.
한국수출입은행 환율 null 응답
환율 데이터는 하루 단위로 영업일 11시 전후에 올라옵니다. 그래서 주말이나 공휴일, 또는 평일 11시 전에 오늘 날짜로 부르면 값이 null로 옵니다. 오류가 아니므로 직전 영업일 날짜(searchdate)로 다시 부르거나 11시 이후에 호출하도록 짜야 합니다.
한국수출입은행 환율을 프로그램으로 받는다면 세 가지만 점검하면 됩니다. 첫째, 요청 주소가 oapi.koreaexim.go.kr인지 확인합니다. 옛 www 주소는 2026년 4월 30일 병행 가동이 끝났습니다. 둘째, result 값을 먼저 읽습니다. 3이면 인증키가 2년 보유기간 만료로 파기됐을 수 있어 새로 받아야 하고, 4면 하루 1000회를 넘긴 것입니다. 셋째, 값이 null이면 휴일이거나 오전 11시 전에 부른 것이니 직전 영업일 날짜로 다시 부릅니다. 받은 값은 쉼표가 든 문자열이고 엔화는 100엔 단위이니 계산 전에 정리해야 합니다. 코드 없이 보려면 누리집 환율정보 화면에서 엑셀로 내려받으면 됩니다.
