로딩중입니다.
Loading...
가림영역
닫기
바로가기 메뉴
본문 바로가기
메뉴 바로가기
페이지 하단 바로가기
계약종별 전력사용량 API 가이드
요청 기본정보
요청 기본정보
메서드 요청URL 인코딩 응답포맷
GET, POST https://bigdata.kepco.co.kr/openapi/v1/powerUsage/contractType.do UTF-8 JSON, XML
요청 인자
요청 인자
항목명 항목설명 타입 필수여부 세부내용
year 조회연도 STRING 필수 조회연도(YYYY)
month 조회월 STRING 필수 조회월(MM)
metroCd 시도코드 STRING 선택 광역자치단체 코드(ex: 11-서울특별시, 26-부산광역시, 41-경기도)
※ 미선택 시 모든 시도 응답
※ 공통코드(법정) API로 조회
cityCd 시군구코드 STRING 선택 기초자치단체 코드(ex: 110-청주시, 830-양평군, 680-강남구)
※ 미선택 시 모든 시군구 응답
※공통코드(법정) API로 조회
cntrCd 계약종별 STRING 선택 한국전력 전기계약종별(ex:100-주택용, 200-일반용)
※ 미선택 시 모든 계약종별 응답
※ 공통코드 API로 조회
apiKey API 인증키 STRING 필수 발급받은 API 인증키 40자리
returnType 응답포맷 STRING 선택 json : JSON 포맷 응답
xml : XML 포맷 응답
※ 미선택 시 JSON으로 응답
응답 결과
응답 결과
항목명 항목설명 타입 세부내용
totData 계약종별 전력사용량 합계 내역 LIST metroCd 미선택 시 모든 지역의 계약종별 전력사용량 내역을 담은 리스트 자료형
※아래의 응답결과 저장
data 계약종별 전력사용량 내역 LIST metroCd 선택 시 특정 지역의 계약종별 전력사용량 내역을 담은 리스트 자료형
※아래의 응답결과 저장
year 조회연도 STRING 조회연도(YYYY)
month 조회월 STRING 조회월(MM)
metro 시도명 STRING 광역자치단체 명(ex:서울특별시, 경기도, 부산광역시 등)
city 시군구명 STRING 기초자치단체 명(ex:청주시, 양평군, 강남구 등)
cntr 계약종별 STRING 한국전력 전기계약종별(ex:주택용, 일반용 등)
custCnt 고객호수 NUMBER 전기사용 고객 호수(호)
powerUsage 전력사용량 NUMBER 전력사용량 합계(kWh)
bill 전기요금 NUMBER 전기요금 합계(원)
unitCost 평균판매단가 NUMBER 전기요금 평균판매 단가(원/kWh)
요청 응답 샘플
요청 응답 샘플
API 요청 예시 https://bigdata.kepco.co.kr/openapi/v1/powerUsage/contractType.do?year=2020&month=11&metroCd=11&cityCd=110&cntrCd=100&apiKey=xxx&returnType=json
API 응답 예시(JSON)
"data" 
: [
     {
       "year": "2020",
       "month": "11",
       "metro": "서울특별시",
       "city": "종로구",
       "cntr": "주택용",
       "custCnt": 65209,
       "powerUsage": 20468684,
       "bill": 2366461741,
       "unitCost": 115.6
     }       
  ]
요청 응답 샘플(선택인자 미입력)
요청 응답 샘플
API 요청 예시 https://bigdata.kepco.co.kr/openapi/v1/powerUsage/contractType.do?year=2020&month=11&metroCd=11&cityCd=110&apiKey=xxx&returnType=json
API 응답 예시(JSON)
"data" 
: [
     {
       "year": "2020",
       "month": "11",
       "metro": "서울특별시",
       "city": "종로구",
       "cntr": "가로등",
       "custCnt": 10287,
       "powerUsage": 793099,
       "bill": 87834879,
       "unitCost": 110.7
     }
    ,{
       "year": "2020",
       "month": "11",
       "metro": "서울특별시",
       "city": "종로구",
       "cntr": "교육용",
       "custCnt": 128,
       "powerUsage": 7044572,
       "bill": 719036541,
       "unitCost": 102.1
     }
    ,{
       "year": "2020",
       "month": "11",
       "metro": "서울특별시",
       "city": "종로구",
       "cntr": "농사용",
       "custCnt": 11,
       "powerUsage": 870,
       "bill": 71023,
       "unitCost": 81.6
     }           
     
       ...... 
        
  ]
비밀번호 입력
비밀번호 변경