최종 수정일: 2026년 05월 06일
한전 API: 전력 데이터의 문을 열다
한전 API를 처음 접한 것은 2022년 여름, 작은 에너지 스타트업에서 ‘전기 사용량 데이터를 앱으로 보여주면 어떨까?’라는 생각으로 사이드 프로젝트를 진행하던 중이었습니다. 당시 복잡한 문서와 생소한 용어들로 어려움을 겪었지만, API를 통해 실제 전력 데이터가 화면에 표시되었을 때의 경험은 잊을 수 없습니다. 이 경험을 통해 데이터가 우리 생활을 변화시키고 새로운 가치를 창출할 수 있는 중요한 자원임을 깨달았습니다. 이제 최고의 전력 데이터 활용 기회를 한전 API가 제공합니다.
한전 API란 무엇인가?
‘한전 API’를 온전히 이해하기 위해선, 우선 ‘API’가 무엇인지 가볍게 짚고 넘어가는 편이 좋습니다. API(Application Programming Interface)라는 어려운 이름 때문에 지레 겁먹을 수도 있습니다만, 사실 그 개념은 마치 식당의 점원처럼 아주 간단합니다.
> 주방에 직접 들어가 요리할 수는 없어도, 점원에게 메뉴판을 보고 주문하면 원하는 음식을 가져다주는 모습과도 같지요. API는 어떤 프로그램(주방)이 가진 기능이나 데이터(요리)를 다른 프로그램(손님)이 정해진 규칙(주문)에 따라 요청하고 받아볼 수 있도록 해주는 ‘연결 통로’를 뜻합니다.
이 개념을 그대로 가져와 본다면, 한전 API는 한국전력공사라는 거대한 데이터 주방이 가진 ‘전력 데이터’라는 메뉴를 외부 개발자나 기업들이 자신의 앱이나 서비스에서 쉽게 주문해 받아볼 수 있도록 만든 공식적인 통신 창구라 하겠습니다. 개인적으로, 전력 정보 API는 과거 소수의 전문가만 접근할 수 있었던 전력 소비량, 실시간 전기 요금, 국가 전력 수급 현황처럼 귀하다고 여겨지던 정보들을 아이디어만 있다면 누구나 활용할 수 있게 하여 전력 데이터 활용의 문턱을 낮추는 데 크게 기여했다고 생각합니다.
에너지 관리 시스템(EMS), 스마트홈 앱, 전력 사용량 분석 서비스 등 혁신적인 서비스들이 탄생할 수 있는 토양은 바로 이 덕분에 마련된 것입니다. 공공데이터포털(data.go.kr)에서 이루어지고 있는 정부의 공공데이터 활성화 정책이 바로 이러한 데이터 개방을 이끈 주역이라 하겠습니다. 많은 개발자가 이 데이터를 활용해 새로운 비즈니스 모델을 구상하고 있습니다. 정부 역시 그 가치를 높이 평가하여 API 제공량을 대폭 확대하는 등 적극적인 지원을 아끼지 않고 있는데, 이 정보 개방 서비스는 단순한 데이터 창구를 넘어 우리나라 에너지 산업의 혁신을 이끄는 핵심 인프라로 굳건히 자리 잡고 있습니다.
| 구성 요소 | 설명 |
|---|---|
| API (Application Programming Interface) | 프로그램 간의 ‘연결 통로’ |
| 한국전력공사 | 전력 데이터의 ‘주방’ (데이터 제공자) |
| 한전 API | 한국전력공사의 전력 데이터를 외부에 ‘공개하는 통신 창구’ |
| 외부 개발자/기업 | ‘손님’ (데이터 사용자) |

한전 API 종류
한전 API는 사용자가 원하는 목적에 따라 데이터를 골라 쓸 수 있도록 여러 종류의 ‘메뉴’를 제공합니다. 개발자는 각 API가 담고 있는 고유한 정보를 통해 자신의 서비스에 딱 맞는 데이터를 정확하게 선택할 수 있습니다.
- 전력사용량 조회 API: 이 API는 특정 고객번호를 이용해 과거 전력 사용량을 월별, 일별, 심지어 시간대별로 상세하게 조회할 수 있습니다. 가계부 앱에 연동하면 우리 집의 전기 사용 패턴을 한눈에 파악하여 불필요한 낭비를 효과적으로 줄일 수 있습니다. 기업은 공장의 시간대별 전력 사용량을 분석해 생산 효율을 높이고 전기 요금을 절감하는 데 활용할 수 있습니다.
- 전력요금 조회 API: 사용한 전력량을 바탕으로 예상 전기 요금을 계산해 주거나, 과거 청구된 요금 내역을 확인하는 기능을 제공합니다. 우리나라의 복잡한 누진제 구간까지 자동으로 계산해 주어 사용자의 “이달에 전기를 이만큼 썼는데 요금이 얼마나 나올까?” 하는 궁금증을 쉽게 해결해 줍니다. 이 기능은 전기 절약을 유도하는 데 효과적입니다.
- 실시간 전력수급 현황 API: 우리나라 전체의 전력 상황을 실시간으로 파악할 수 있는 중요한 지표를 제공합니다. 현재 전기를 얼마나 만들고 있는지(공급량), 얼마나 쓰고 있는지(수요량), 더불어 얼마나 여유가 있는지(예비율)를 15분 간격으로 알려줍니다. 전력망의 안정성을 유지해야 하는 수요 반응(DR) 서비스나 가상발전소(VPP) 같은 차세대 에너지 사업에서 이 데이터가 핵심 정보로 활용되고 있습니다.
- 전력설비 정보 API: 발전소, 변전소 등 국가의 중요한 전력 인프라 시설의 위치나 용량 같은 정보를 제공합니다. 주로 연구기관에서 전력망의 효율성을 분석하거나 새로운 신재생에너지 발전소의 최적 입지를 찾는 등의 연구 목적으로 활용됩니다. 대부분 웹에서 표준처럼 쓰이는 REST 방식으로 데이터를 주고받으며, 그 결과는 주로 JSON이나 XML 형태로 제공되어 다루기 매우 편리합니다.

한전 API 사용 방법 및 절차
풍부한 전력 데이터를 자신의 서비스에 활용하기 위해서는 정해진 절차에 따라 차근차근 단계를 밟아나가야 합니다. 이 과정은 크게 ‘신청’, ‘사용’, ‘연동’이라는 세 단계로 나누어 볼 수 있습니다.
| 단계 | 주요 내용 |
|---|---|
| 신청 | 공공데이터포털에서 API 활용 신청 및 서비스 키 발급 |
| 사용 | 발급된 서비스 키를 이용해 데이터 요청 및 응답 처리 |
| 연동 | 애플리케이션에 API 통합 및 자동화된 데이터 활용 시스템 구축 |

한전 API 신청
모든 시작은 정부의 공공데이터를 한곳에 모아놓은 공공데이터포털(data.go.kr)에서 이루어집니다. 신청 절차는 비교적 간단합니다. 먼저 공공데이터포털에 접속하여 회원가입을 마쳐야 합니다. 로그인한 뒤, 검색창에 ‘한국전력공사’나 ‘전력사용량’ 같은 키워드로 원하는 API를 찾아보세요. 마음에 드는 API를 찾았다면 ‘활용신청’ 버튼을 누르고 신청서를 작성하면 됩니다. API를 사용하려는 목적을 최대한 구체적이고 진정성 있게 작성하는 편이 좋습니다. 가령 ‘에너지 절약을 돕는 개인 가계부 앱 개발을 위해 월별 전력 사용량 데이터 활용’처럼 명확하게 쓰는 것이 좋습니다.
신청서를 제출하면 보통 2~3일 내에 심사가 완료되어 승인이 이루어집니다. 그러면 마이페이지에서 API를 호출할 때 사용할, 나만의 비밀 열쇠인 서비스 키(API Key)를 발급받게 됩니다. 이 키는 외부로 유출될 경우 심각한 문제가 발생할 수 있으므로, 나만의 비밀번호처럼 소중하게 관리해야 합니다. 신청 목적을 성실하게 작성하는 것이 승인 확률을 높이는 가장 좋은 방법입니다. 신청서를 심사할 때 중요하게 여기는 것은 단순히 정보를 열람하려는 목적을 넘어 사회에 도움이 되거나 혁신적인 서비스를 만들려는 진정성이기 때문입니다.

한전 API 사용법
서비스 키를 발급받았다면 이제 데이터를 요청해 볼 차례입니다. 한전 API는 웹에서 가장 널리 쓰이는 RESTful 방식으로 통신하고 있으니, 기본적인 원리만 이해하면 누구나 쉽게 사용할 수 있습니다.
초기 개발 시 많은 개발자가 겪는 문제 중 하나는 \SERVICE_KEY_IS_NOT_REGISTERED_ERROR\ 오류입니다. 이는 주로 서비스 키에 포함된 특수문자를 URL에 그대로 사용했을 때 발생합니다. 웹 주소에서는 특수문자를 다른 문자로 바꿔주는 ‘URL 인코딩’ 과정이 필수적입니다. 이 처리를 누락하면 오류가 발생하며, 인코딩 함수를 적용하면 데이터가 정상적으로 수신됩니다.
API를 사용하려면 정해진 주소(URL)에 필수 정보들을 덧붙여 요청을 보내야 합니다. 필수 정보에는 대개 다음과 같은 것들이 포함됩니다.
serviceKey: 발급받은 인증키입니다. 반드시 URL 인코딩 처리를 해야 합니다.
numOfRows: 한 번에 가져올 데이터의 개수를 나타냅니다.
pageNo: 몇 번째 페이지의 데이터를 가져올지 지정하는 값입니다.
여기에 더해 조회할 날짜나 고객번호 등 각 API의 특성에 맞는 정보들을 추가로 넣어주게 됩니다.
이렇게 요청을 보내면 서버는 JSON이나 XML 형식으로 응답을 보내줍니다. 응답 메시지 속 resultCode라는 항목을 잘 살펴보세요. 이 값이 “00”이면 성공을, 다른 숫자면 에러를 의미하니 개발할 때 이 부분을 면밀히 처리하는 것이 중요합니다.

한전 API 연동
API 연동은 단순히 데이터를 한 번 불러오는 것을 넘어, 자신의 애플리케이션에 완전히 통합시켜 자동으로 데이터를 활용하게 만드는 과정입니다. 안정적인 서비스를 만들려면 몇 가지를 반드시 지키셔야 합니다.
첫째, 안정적인 데이터 처리 구조를 설계해야 합니다. 사용자가 버튼을 누를 때마다 전력 데이터 API를 실시간으로 호출하면 응답이 늦어져 사용자는 답답함을 느낄 수도 있습니다. API를 호출해놓고 다른 작업을 처리한 뒤 데이터가 도착하면 화면을 업데이트하는 비동기 처리 방식을 활용해 보시겠어요?
둘째, API 서버를 배려하는 호출 정책을 반드시 따라야 합니다. 짧은 간격으로 API를 계속해서 호출하면 서버에 부담이 커져 서비스 이용이 제한될 수도 있으니 주의해야 합니다. 여기에 덧붙여 한 번에 수만 건의 데이터를 가져와야 한다면, 한 번에 다 달라고 요청하기보다는 pageNo 값을 바꿔가며 여러 번에 걸쳐 나눠서 요청하는 페이징 처리를 반드시 구현해야만 합니다. 안정적인 서비스를 위해서는 재시도 로직과 페이징 처리는 선택이 아닌 필수입니다.

한전 API, 어떻게 활용할 수 있을까?
한전 API의 다양한 매력은 데이터를 기반으로 현실의 문제를 해결하고 새로운 가치를 만들어낼 무궁무진한 가능성을 품고 있습니다. 에너지 효율을 높이고 비용을 절감하며, 나아가 더 깨끗한 환경을 만드는 데 기여하는 유용한 서비스들이 바로 이 API를 통해 만들어지고 있습니다.

한전 API 활용
한전 API는 에너지, IT, 컨설팅 등 다양한 분야에서 혁신적인 아이디어와 결합하여 빛을 발하고 있습니다.
- 에너지 관리 시스템(EMS) 및 스마트 빌딩: 에너지 비용을 크게 절감한 한 제조업체의 사례가 있습니다. 이 제조업체는 전력 피크 시간대를 피해 설비를 가동하는 데 전력 데이터 API의 데이터를 활용했다고 합니다. 이처럼 공장이나 대형 빌딩에서는 이 데이터를 활용하여 실시간 전력 사용량 데이터를 받아 자체 관리 시스템과 연동합니다. 어떤 기계가 전기를 많이 쓰는지, 어느 시간대에 낭비가 심한지 등을 정밀하게 분석하여 에너지 비용을 크게 줄이는 것이 가능해집니다.
- 전력 사용 패턴 분석 및 컨설팅: 개인을 대상으로는 월별 전력 사용량을 분석해 주는 앱을 만들 수 있습니다. “지난달보다 에어컨 사용량이 30% 늘었네요!”와 같은 맞춤형 조언을 제공하기도 합니다. 기업을 대상으로는 전력 사용 패턴을 분석해 현재 요금제가 최적인지 진단하고, 더 저렴한 요금제로 변경하도록 제안하는 컨설팅 서비스를 제공하여 긍정적인 평가를 받고 있습니다.
- 수요반응(DR) 서비스: 국가 전체의 전력망을 안정시키는 매우 효율적이고 스마트한 방법으로 수요반응(DR) 서비스가 있습니다. 한여름 전력 사용이 폭증하여 전력 예비율이 위험 수준으로 떨어질 때, DR 사업자는 실시간 전력수급 현황 API로 이 상황을 감지하고, 자신들의 고객인 공장이나 빌딩에 “지금 잠시 전기 사용을 줄여주시면 보상금을 드립니다”라고 요청하는 방식입니다.
이러한 활용 사례 덕분에 국내 에너지 데이터 시장은 연평균 25%가 넘는 높은 성장률을 보이고 있습니다. 앞으로는 전기차 충전 인프라와 결합된 서비스가 한전 API의 가장 큰 잠재력을 보여줄 것으로 예상됩니다. 전력망이 가장 한가한 새벽 시간대에 자동으로 전기차를 충전하고 요금 할인을 받는 서비스 등이 가능할 것으로 보입니다.
결론적으로, 전력 데이터는 이제 더 이상 단순한 기록에 머무르지 않습니다. 우리 사회의 에너지 효율을 극대화하고 새로운 산업을 일으키는 혁신의 씨앗이 됩니다. 그리고 이 씨앗을 누구나 싹 틔울 수 있도록 문을 활짝 열어주는 것이 바로 한전 API가 제공하는 다양한 가능성입니다.

한전 API는 누구나 무료로 사용할 수 있는지요?
네, 대한민국 국민이나 국내 사업자라면 공공데이터포털에서 간단한 신청 절차를 거쳐 누구나 무료로 활용할 수 있습니다. 다만, 서버의 안정적인 운영을 위해 하루에 호출할 수 있는 횟수는 제한되어 있습니다. 기본적으로는 하루 1,000회까지 호출할 수 있으며, 사업 계획을 제출하면 최대 10,000회까지 늘릴 수 있습니다.
한전 API 사용을 위해 어떤 프로그래밍 언어를 사용해야 할까요?
한전 API는 특정 언어에 얽매이지 않습니다. 웹 표준 기술을 사용하기에 파이썬(Python), 자바(Java), 자바스크립트(JavaScript) 등 HTTP 요청을 보낼 수 있는 거의 모든 최신 프로그래밍 언어로 개발하는 것이 가능합니다. 각 언어마다 관련 라이브러리가 잘 되어 있어서 생각보다 어렵지 않게 시작할 수 있습니다.
한전 API 사용 시 ‘SERVICE_KEY_IS_NOT_REGISTERED_ERROR’ 오류가 나타나 고민입니다.
이 오류는 많은 개발자가 겪을 수 있는 문제입니다. 원인은 크게 두 가지입니다. 첫째, 서비스 키를 잘못 복사했을 때입니다. 둘째, 그리고 더 흔한 경우는 바로 서비스 키를 ‘URL 인코딩’하지 않았을 때입니다. 서비스 키에 포함된 ‘/’, ‘+’ 같은 특수문자는 웹 주소창에서 제대로 인식되지 않으니 반드시 변환 과정을 거쳐야 합니다.
한전 API로 우리 집의 실시간 전력 사용량을 바로 확인하는 것이 가능할까요?
아쉽지만 개인정보보호 때문에 특정 가구의 전력 사용량을 제3자가 실시간으로 직접 조회하는 것은 불가능합니다. 전력사용량 조회 API는 본인의 고객번호를 인증하여 자신의 과거 사용 내역을 조회하는 용도로만 활용됩니다.
한전 API로 사업을 해보고 싶은데, 어떤 아이디어가 좋을까요?
가능성은 실로 다양합니다. 예를 들어 카페나 식당 같은 소상공인을 위한 ‘전기요금 절감 컨설팅 앱’을 만들어보는 것은 어떨까요? 월별 사용량 데이터를 분석해 가장 저렴한 요금제를 추천해 주는 서비스 말입니다. 여기에 더해 태양광 패널을 설치한 가정을 대상으로 날씨 데이터와 전력수급 현황 API를 결합하여 오늘의 예상 발전량과 판매 수익을 예측해 주는 서비스도 매우 유용할 것입니다.
14년차 백엔드 개발자
“API에 대해 쉽게 설명해드려요“