You are on page 1of 11

SGSGSGSG SGSF-041-1-2

SGSGSGS
SGSGSG
SGSGS
SGSG
SGS
SG SG
전력 빅데이터
관리 체계 인터페이스
— 제1부: 전력데이터 군
SGSF-041-1-1

한 국 스 마 트 그 리 드 협 회
2017년 08월 10일 작업초안(WD) 완료
SGSF-041-1-1
SGSF-041-1-1

목 차

1 적용범위 .................................................................................................................................................. 1

2 인용표준 .................................................................................................................................................. 1

3 용어와 정의 ............................................................................................................................................. 1

4. 전력 데이터 군 요구사항 ........................................................................................................................ 1

5 빌딩/아파트 수용가 데이터 ................................................................................................................... 2
5.1 서비스정보 ........................................................................................................................................ 2
5.2 서비스보안 ........................................................................................................................................ 2
5.3 인터페이스표준 ................................................................................................................................. 2
5.4 OpenAPI 정보 ................................................................................................................................... 2
5.5 오퍼레이션 목록 ............................................................................................................................... 2
5.6 API 명세 ......................................................................................................................................... 2

-i-
SGSF-041-1-1

개 요

이 문서는 전력 데이터 군에 대하여 3개의 데이터(가정/상가 수용가 데이터, 빌딩/공장/아파트 수용가
데이터, 배전/송전/송변전 데이터)로 구분하였으며. 전력 빅데이터 표준화 2차년도 과제목표인 빌딩과
아파트 수용가 데이터에 대한 작업초안(WD)을 완료 하였다..

나머지 2개 데이터(빌딩/공장/아파트 수용가 데이터, 배전/송전/송변전 데이터)에 대한 내용은 계속 과
제로 추후 작성 할 예정이다.

- ii -
한국스마트그리드협회 단체표준

SGSF-041-1-1

전력 빅데이터 관리 체계 인터페이스
— 제1부: 전력 데이터 군
Bigdata Management Systems Interface of Electricity
— Part 1: Data Group of Electricity

1 적용범위

이 표준은 전력 데이터 군에 대하여 3개의 데이터(가정/상가 수용가 데이터, 빌딩/공장/아파트 수용가
데이터, 배전/송전/송변전 데이터)로 구분하여 제 3자에게 각 데이터의 정보전달의 목적을 가지고 있
다. 제공되는 정보는 HTTP 기반으로 정보를 GET 방식이나 POST 방식으로 요청(Request)하고, 응
답은 경계정보, API는 KML/GeoJson 형식으로 받을 수 있다.

2 인용표준

다음의 인용표준은 전체 또는 부분적으로 이 표준의 적용을 위해 필수적이다. 발행연도가 표기된 인
용 표준은 인용된 판만을 적용한다. 발행연도가 표기되지 않은 인용표준은 최신판(모든 추록을 포함)
을 적용한다.

3 용어와 정의

이 표준의 목적을 위하여 다음의 용어와 정의를 적용한다.

3.1
OpenAPI
인터넷 이용자가 일방적으로 웹 검색 결과 및 사용자인터페이스(UI) 등을 제공받는 데 그치지 않고
직접 응용 프로그램과 서비스를 개발할 수 있도록 공개된 API(application programming interface)

3.2
Query String
REST API의 요청 시 key-value 형식으로 저장되는 변수를 의미한다. GET 방식일 때는 URL 뒤
에 ?key1=value1&key2=value2의 형태로 전달되는 데이터를 의미하고, POST 형식일 경우 Body 영역
내용을 의미한다.
SGSF-041-1-1

4 전력 데이터 군 요구사항

표 1 ― 전력 데이터 군 서비스명

순번 서비스 ID 서비스명(영문) 서비스명(국문)
1 Home and Mall - Home and Mall Data 가정/상가 수용가 데이터
2 Building and APT - Building and APT Data 빌딩/아파트 수용가 데이터
3 Electric Dist/Transfer - Electric Dist/Transfer Data 배전/송전/송변전 데이터

5 빌딩/아파트 수용가 데이터

5.1 서비스 정보

5.1.1 서비스명

빌딩 및 아파트 수용가 데이터

5.1.2 서비스 설명

빌딩과 아파트 수용가에서 소비한 전력량의 검침 일자별/블럭별 합계 (아파트의 경우 동별) 정보를
제공

5.2 서비스 보안

5.2.1 서비스 인증

- 서버: apikey
- Mobile: Oauth2

5.3 인터페이스 표준

REST API 스타일을 사용한다.

5.4 OpenAPI 정보

Request-Response 형식을 사용하며, 서버와 클라이언트 간 통신 데이터 포맷은 JSON 형식을 따른
다.

5.5 오퍼레이션 목록

표 2 — 오퍼레이션 목록

2
SGSF-041-1-2

서비스 명 오퍼레이션명(영문) 오퍼레이션명(국문) 오퍼레이션 설명
아파트 수용가 전력 (단지 주소, 검침 일자, 전력
Apt_Power
수용가 전력 소비량 조회 사용량) 정보를 제공
데이터 빌딩 수용가 전력 (빌딩 주소, 검침 일자, 전력
Building_Power
소비량 조회 사용량 정보)를 제공

5.6 API 명세

5.6.1 아파트 수용가 전력 사용량 정보 조회

5.6.1.1 설명

단지 주소, 검침 일자, 전력 사용량 정보를 제공

5.6.1.2 요청형식

• HTTP method: POST
• API version: 1.0
• Permission: User
• URL: /power/apt/load

• Query Param
Field Type Description
cmpx_addr1 String 단지 주소(시/군/구), 필수입력
cmpx_addr2 String 단지 주소(동/읍/면/리), 필수입력
cmpx_name String 단지 명, 필수입력
date String 검침시작일을 YYYYMMDD 형태로 입력, 필수입력

5.6.1.3 응답 형식

Field Type Description
cmpx_code String 단지 주소 (시/군/구, 동/읍/면/리)
cmpx_name String 단지 명
cmpx_part String 동 구분
insp_stdt String 검침 시작일시, 예> 201407010000
insp_endt String 검침 종료일시, 예> 201407012359
use_qty Double 사용량, 예> 25.20

3
SGSF-041-1-1

• Success Response Examples

[
{
"cmpx_code": "강동구 상일동",
"cmpx_name": "명일중앙하이츠아파트",
"insp_stdt": "201407010000",
"insp_endt": "201407012359",
"use_qty": 25.20
}
]

5.6.2 빌딩 수용가 전력 사용량 정보 조회

5.6.2.1 설명

빌딩 주소, 검침 일자, 전력 사용량 정보를 제공

5.6.2.2 요청형식

• HTTP method: POST
• API version: 1.0
• Permission: User
• URL: /power/building/load

• Query Param
Field Type Description
bld_code1 String 빌딩 주소(시/군/구), 필수입력
bld_code2 String 빌딩 주소(동/읍/면/리), 필수입력
bld_name String 빌딩 명, 필수입력
date String 검침시작일을 YYYYMMDD 형태로 입력, 필수입력

5.6.2.3 응답 형식

Field Type Description
bld_code String 빌딩 주소 (시/군/구, 동/읍/면/리)
bld_name String 빌딩 명
bld_part String 동 구분
bld_flr String 층 구분
insp_stdt String 검침 시작일시, 예> 201407010000
insp_endt String 검침 종료일시, 예> 201407012359

4
SGSF-041-1-2

use_qty Double 사용량 (소숫점 2자리) 예> 25.20

• Success Response Examples

[
{
"bld_code": "강동구 상일동",
"cmpx_name": "고덕사회체육센터",
"bld_part": "1",
"bld_flr": "1"
"insp_stdt": "201407010000",
"insp_endt": "201407012359",
"use_qty": 25.20
}
]

5.6.3 Error Code

코드 번호 Field Description

InvalidHeaderError HTTP 헤더가 인증을 포함하지 않음
다음과 같은 경우 발생
400 - 필수 파라미터가 전달되지 않음
InvalidContentError
- 파라미터가 유효하지 않음
- 기타 파라미터 오류
403 NotAuthorizeError 유효하지 않은 인증 권한 인 경우
404 ResourceNotFoundError 요청된 리소스가 존재하지 않음
500 InternalError 기타 서버 오류

• Error Response Example

HTTP/1.1 400 Bad Request
{
“code”: “InvlalidContentError”,
“message”: “Parameter is missing”
}

5
SGSF-041-1-1(Ed1.0)

SGSGSG
GSGSG
SGSG
GSG
SG
GSG
SGSG
GSGSG
SGSGSG
Bigdata Management Systems
Interface of Electricity
-Part 1: Data Group of Electricity
ICS