- 에너지 현황
- 에너지 통계
- 에너지 정보
- 에너지 커뮤니티
Open API 이용안내
광주광역시 에너지플랫폼에서 제공하는 에너지 관련 공공데이터를 오픈API로 개발하여, 개발자가 웹이나 모바일앱 등으로 개발이 용이하도록 제공합니다.
-
STEP 01
Open API 서비스 신청
-
STEP 02
관리자 승인 및 인증키 발급
-
STEP 03
Open API 활용
01. 오픈 API 서비스 신청
- Open API 서비스 신청은 에너지정보플랫폼에서 로그인 후 신청 가능합니다.
- Open API 제공목록에서 신청버튼을 클릭하여 신청합니다.
02. 관리자 승인 및 인증키 발급
- 신청자가 작성한 활용 목적 등을 검토하여 관리자가 사용 승인여부를 결정합니다.
- Open API 신청내용은 Open API 제공목록에서 신청확인 버튼을 통해 관리자의 승인여부, 인증키 내용을 확인할 수 있습니다.
- 인증키는 관리자의 승인 후 발급되는 것으로 발급된 인증키를 통하여 해당 서비스를 활용 할 수 있습니다.
03. Open API 활용
- 발급된 인증키를 사용하여 API를 제공 형식에 따라 사용할 수 있습니다.
- 자세한 내용은 제공목록에서 제공되는 설명글이나 문서를 참고해주세요.
- API URL
- https://www.gwangjuenergy.com/openapi/data/building
요청 파라미터
| Element | Description | |
|---|---|---|
| serviceKey | 필수 | 제공한 키(Key) 정보 |
| yyyymm | 필수 | 년월 |
| energyType | 필수 | 에너지 유형 - 전기 : elect - 가스 : gas - 수도 : water - 열 : hit |
반환 값
| Element | Description |
|---|---|
| yyyymm | 년월 |
| energyType | 에너지 유형 |
| gu | 구 |
| dong | 동 |
| gubun | 건물유형 |
| gubunCnt | 건물유형 건수 |
| usage | 사용량 |
| carbon | 온실가스배출량 |
사용 예시
REQUEST
https://www.gwangjuenergy.com/openapi/data/building?serviceKey=XXXX&yyyymm=202211&energyType=elect
RESPONSE
{
"result" : "success",
"info_cnt" : 9,
"Info": [{
"yyyymm" : 202211,
"energyType" : 전기,
"gu" : 광산구,
"dong" : 고룡동,
"gubun" : 단독주택,
"gubunCnt" : 133,
"usage" : 113025.0,
"carbon" : 10
}, {
"yyyymm" : 202211,
"energyType" : 전기,
"gu" : 광산구,
"dong" : 고룡동,
"gubun" : 제1종근린생활시설,
"gubunCnt" : 4,
"usage" : 431.0,
"carbon" : 10
}, {
- API URL
- https://www.gwangjuenergy.com/openapi/data/haengjeongdong
요청 파라미터
| Element | Description | |
|---|---|---|
| serviceKey | 필수 | 제공한 키(Key) 정보 |
| yyyymm | 필수 | 년월 |
| energyType | 필수 | 에너지 유형 - 전기 : elect - 가스 : gas - 수도 : water - 열 : hit |
반환 값
| Element | Description |
|---|---|
| yyyymm | 년월 |
| energyType | 에너지 유형 |
| gu | 구 |
| dong | 동 |
| usage | 사용량 |
| carbon | 온실가스배출량 |
사용 예시
REQUEST
https://www.gwangjuenergy.com/openapi/data/haengjeongdong?serviceKey=XXXX&yyyymm=202211&energyType=elect
RESPONSE
{
"result" : "success",
"info_cnt" : 9,
"Info": [{
"yyyymm" : 202211,
"energyType" : 전기,
"gu" : 광산구,
"dong" : 고룡동,
"usage" : 113025.0,
"carbon" : 10
}, {
"yyyymm" : 202211,
"energyType" : 전기,
"gu" : 광산구,
"dong" : 고룡동,
"usage" : 431.0,
"carbon" : 10
}, {
- API URL
- https://www.gwangjuenergy.com/openapi/data/industry
요청 파라미터
| Element | Description | |
|---|---|---|
| serviceKey | 필수 | 제공한 키(Key) 정보 |
| yyyymm | 필수 | 년월 |
| energyType | 필수 | 에너지 유형 - 전기 : elect - 가스 : gas - 수도 : water |
반환 값
| Element | Description |
|---|---|
| yyyymm | 년월 |
| energyType | 에너지 유형 |
| complex | 산업단지 |
| usage | 사용량 |
| carbon | 온실가스배출량 |
사용 예시
REQUEST
https://www.gwangjuenergy.com/openapi/data/industry?serviceKey=XXXX&yyyymm=202211&energyType=elect
RESPONSE
{
"result" : "success",
"info_cnt" : 9,
"Info": [{
"yyyymm" : 202211,
"energyType" : 전기,
"complex" : 본촌일반산업단지,
"usage" : 113025.0,
"carbon" : 10
}, {
"yyyymm" : 202211,
"energyType" : 전기,
"complex" : 첨단과학산업단지,
"usage" : 431.0,
"carbon" : 10
}, {