LH 에너지 통합 플랫폼

연동가이드

문서 정보

프로젝트	LH 에너지 통합 플랫폼
작업	활용가이드 작성
산출물	EV 시스템 연계 API 가이드

재·개정 이력

버전	변경일	변경내용	작성자	승인
1.0	2022.11.07	최초작성

목  차

1. 서비스 목록	4

2. 서비스 명세	5

2.1 충전소 시설정보	5

2.2 충전 이력 등록	8

2.3 유지보수 이력 등록	11

2.4  충전기 상태 등록	14

3. 에러코드 명세	17

3.1 응답 메시지 에러코드 및 설명	17

서비스 목록

No	서비스ID	서비스명(국문)	서비스명(영문)
1	evcsInfoList	충전소 시설정보 조회
2	evchrHist	충전 이력 등록
3	mntnHist	유지보수 이력 등록
4	status	충전기 상태
5
6
7
8
9
10
11
12
13
14
15

서비스 명세

충전소 시설정보

서비스개요

구분	세부항목	관련정보
서비스 정보	서비스 ID	evcpInfoList
	서비스명(국문)	충전소 시설정보 조회
	서비스명(영문)
	서비스 설명	해당단지 충전소 시설정보를 조회하는 서비스
서비스 보안	서비스 인증/권한	서비스키※ (통합시스템에서 확인)
	메시지 레벨 암호화	없음
	전송 레벨 암호화	없음
적용 기술 수준	인터페이스 표준	REST (GET)
	교환 데이터 표준	JSON
서비스 URL	운영환경	https://eep.lh.or.kr/api/ev/evcp/evcsInfoList
서비스 배포 정보	서비스 버전	1.0
	유효일자	N/A	배포 일자	N/A
	서비스 이력	N/A
사용 제약 사항 (비고)		N/A

오퍼레이션 정보

오퍼레이션 정보	오퍼레이션 번호	1
	오퍼레이션명(국문)	충전소 시설정보 조회
	오퍼레이션명(영문)
	오퍼레이션 설명	충전소내 충전기 시설의 CSMS접속 인증 정보를 조회하는 서비스
	Call Back URL	N/A
	최대 메시지 사이즈	[ 1000Kbytes ]
	평균 응답시간	[ 500ms ]
	초당 최대 트랜잭션	[ 30tps ]

요청 메시지 명세

항목명(영문)	항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

응답 메시지 명세

항목명(영문)		항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명
resultCode		결과코드	2	1	200	결과코드
resultMsg		결과메세지	50	1	정상	결과메세지
evcsInfoTotalPage		모든 페이지 수	6	1
evcsInfoTotalCount		모든 결과 수	6	1
evcsInfoList
	sbdId	단지 아이디	6	1	9999
	eqpSn	충전기 아이디	6	1	9999

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

요청 / 응답 메시지 예제

REST(URL)

https://eep.lh.or.kr/api/ev/evcp/evcsInfoList

응답 메세지

{

"resultMsg": "Ok",

"resultCode": 200,

"evcsInfoTotalPage": 1,

"evcsInfoTotalCount": 10,

"evcsInfoList": [

{

"sbdId": "C90547",

"eqpSn": 1

},

{

"sbdId": "C90547",

"eqpSn": 2

},

{

"sbdId": "C90547",

"eqpSn": 3

}

]

}

충전 이력 등록

서비스개요

구분	세부항목	관련정보
서비스 정보	서비스 ID	evchrHist
	서비스명(국문)	충전 이력 등록
	서비스명(영문)
	서비스 설명	해당단지 충전기의 충전 이력 등록 서비스
서비스 보안	서비스 인증/권한	서비스키※ (통합시스템에서 확인)
	메시지 레벨 암호화	없음
	전송 레벨 암호화	없음
적용 기술 수준	인터페이스 표준	REST (POST)
	교환 데이터 표준	JSON
서비스 URL	운영환경	https://eep.lh.or.kr/api/ev/evcs/evchrHist
서비스 배포 정보	서비스 버전	1.0
	유효일자	N/A	배포 일자	N/A
	서비스 이력	N/A
사용 제약 사항 (비고)		N/A

오퍼레이션 정보

오퍼레이션 정보	오퍼레이션 번호	2
	오퍼레이션명(국문)	충전 이력 등록
	오퍼레이션명(영문)
	오퍼레이션 설명	트랜잭션이 종료 시 충전이력 등록
	Call Back URL	N/A
	최대 메시지 사이즈	[ 1000Kbytes ]
	평균 응답시간	[ 500ms ]
	초당 최대 트랜잭션	[ 30tps ]

요청 메시지 명세

항목명(영문)		항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명
csgnFrmSn		사업자아이디	6	1
sbdId		단지아이디	6	1
eqpSn		충전기 아이디	6	1
chrgStDttm		충전시작일시	20	1	2021-11-08T09:28:00Z
chrgEdDttm		충전종료일시	20	1	2021-11-08T09:28:00Z
chrgDetailList						매시기준 목록
	usEle	충전량	6	2
	usChrg	요금	6	1
	chrgDttm	충전일시(매시간)	20	1

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

응답 메시지 명세

항목명(영문)	항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명
resultCode	결과코드	2	1		결과코드
resultMsg	결과메세지	50	1		결과메세지

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

마. 요청 / 응답 메시지 예제

REST(URL)

https://eep.lh.or.kr/api/ev/evcs/evchrHist

요청 메세지

{

"csgnFrmSn": 99999,

"sbdId": "002073",

"eqpSn": 3,

"chrgStDttm": "2021-12-01T12:00:00Z",

"chrgEdDttm": "2021-12-01T16:00:00Z",

"chrgDetailList" : [

{"usEle": 250.1, "usChrg": 21000 , "chrgDttm" : "2021-12-01T12:59:59Z"},

{"usEle": 250.2, "usChrg": 21100 , "chrgDttm" : "2021-12-01T13:59:59Z"},

{"usEle": 250.3, "usChrg": 21200 , "chrgDttm" : "2021-12-01T14:59:59Z"},

{"usEle": 250.4, "usChrg": 21300 , "chrgDttm" : "2021-12-01T15:59:59Z"},

{"usEle": 250.4, "usChrg": 21300 , "chrgDttm" : "2021-12-01T16:59:59Z"}

]

}

응답 메세지

{

"resultMsg": "Ok",

"resultCode": 200

}

유지보수 이력 등록

서비스개요

구분	세부항목	관련정보
서비스 정보	서비스 ID	mntnHist
	서비스명(국문)	유지보수 이력 등록
	서비스명(영문)
	서비스 설명	해당단지 충전기의 일일 유지보수 이력 등록 서비스
서비스 보안	서비스 인증/권한	서비스키※ (통합시스템에서 확인)
	메시지 레벨 암호화	없음
	전송 레벨 암호화	없음
적용 기술 수준	인터페이스 표준	REST (POST)
	교환 데이터 표준	JSON
서비스 URL	운영환경	https://eep.lh.or.kr/api/ev/evcs/mntnHist
서비스 배포 정보	서비스 버전	1.0
	유효일자	N/A	배포 일자	N/A
	서비스 이력	N/A
사용 제약 사항 (비고)		N/A

오퍼레이션 정보

오퍼레이션 정보	오퍼레이션 번호	3
	오퍼레이션명(국문)	유지보수 이력 등록
	오퍼레이션명(영문)
	오퍼레이션 설명	해당단지 충전기의 일일 유지보수 이력 등록 서비스
	Call Back URL	N/A
	최대 메시지 사이즈	[ 1000Kbytes ]
	평균 응답시간	[ 500ms ]
	초당 최대 트랜잭션	[ 30tps ]

요청 메시지 명세

항목명(영문)		항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명
csgnFrmSn		사업자아이디	6	1
sbdId		단지아이디	6	1
evcsList		목록		0..n
	eqpSn	충전기 아이디	6	1
	mntnStDttm	유지보수 점검 시작일자	20	1	2021-11-08T09:28:00Z
	mntnEdDttm	유지보수 점검 종료일자	20	1	2021-11-08T09:28:00Z
	mntnCd	유지보수 점검 코드	2	1		00:정기점검 01:고장수리
	mntnDtl	유지보수 점검 내용	500	1

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

응답 메시지 명세

항목명(영문)	항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명
resultCode	결과코드	2	1		결과코드
resultMsg	결과메세지	50	1		결과메세지

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

요청 / 응답 메시지 예제

REST(URL)

https://eep.lh.or.kr/api/ev/evcs/mntnHist

요청 메세지

{

"csgnFrmSn": 999,

"sbdId": "C9999",

"evcsList" : [

{

"eqpSn": 99999999,

"mntnStDttm": "2022-02-02T01:00:00Z",

"mntnEdDttm": "2022-02-02T03:00:00Z",

"mntnCd": "00",

"mntnDtl": "정기 점검"

},

{

"eqpSn": 99999999,

"mntnStDttm": "2022-02-02T01:00:00Z",

"mntnEdDttm": "2022-02-02T03:00:00Z",

"mntnCd": "01",

"mntnDtl": "고장 수리"

}

]

}

응답 메세지

{

"resultMsg": "Ok",

"resultCode": 200

}

충전기 상태 등록

서비스개요

구분	세부항목	관련정보
서비스 정보	서비스 ID	status
	서비스명(국문)	충전기 상태 등록
	서비스명(영문)
	서비스 설명	해당단지 충전기의 상태 등록 서비스 (매시간)
서비스 보안	서비스 인증/권한	서비스키※ (통합시스템에서 확인)
	메시지 레벨 암호화	없음
	전송 레벨 암호화	없음
적용 기술 수준	인터페이스 표준	REST (POST)
	교환 데이터 표준	JSON
서비스 URL	운영환경	https://eep.lh.or.kr/api/ev/evcs/status
서비스 배포 정보	서비스 버전	1.0
	유효일자	N/A	배포 일자	N/A
	서비스 이력	N/A
사용 제약 사항 (비고)		N/A

오퍼레이션 정보

오퍼레이션 정보	오퍼레이션 번호	4
	오퍼레이션명(국문)	충전기 상태 등록
	오퍼레이션명(영문)
	오퍼레이션 설명	해당단지 충전기의 상태 등록 서비스 단지내 충전기 상태를 목록 형태로 매시간 전송
	Call Back URL	N/A
	최대 메시지 사이즈	[ 1000Kbytes ]
	평균 응답시간	[ 500ms ]
	초당 최대 트랜잭션	[ 30tps ]

요청 메시지 명세

항목명(영문)			항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명
csgnFrmSn			사업자아이디	6	1
sbdId			단지아이디	6	1
evcsList			목록		1..n
	eqpSn		충전기 아이디	6	1
	ssCd		충전기 상태	4	1	E000	E000:정상 E100:고장 E200:유지보수
	connectorList		커넥터 목록		1..n
		conrId	커넥터 아이디	6	1
		conrSsCd	커넥터 상태	20	1		ocpp1.6 Status
		ssChkDttm	커넥터 상태 체크 일자	20	1

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

응답 메시지 명세

항목명(영문)	항목명(국문)	항목 크기	항목 구분	샘플데이터	항목설명
resultCode	결과코드	2	1		결과코드
resultMsg	결과메세지	50	1		결과메세지

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수건(1..n), 0건 또는 복수건(0..n)

요청 / 응답 메시지 예제

REST(URL)

https://eep.lh.or.kr/lhev/api/v1/evMntnHist

요청 메세지

{

"csgnFrmSn": 1,

"sbdId": "C90547",

"evcsList" : [

{

"eqpSn": 3,

"ssCd": "E001",

"connectorList" : [

{"conrId": 1, "conrSsCd": "Available", "ssChkDttm": "2021-10-27T14:28:00Z"},

{"conrId": 2, "conrSsCd": "Available", "ssChkDttm": "2021-10-27T14:28:00Z"}

]

},

{

"eqpSn": 4,

"ssCd": "E001",

"connectorList" : [

{"conrId": 1, "conrSsCd": "Available", "ssChkDttm": "2021-10-27T14:28:00Z"},

{"conrId": 2, "conrSsCd": "Faulted", "ssChkDttm": "2021-10-27T14:28:00Z"}

]

}

]

}

응답 메세지

{

"resultMsg": "Ok",

"resultCode": 200

}

에러코드 명세

응답 메시지 에러코드 및 설명

에러 코드	코드 종류	설명
00	NORMAL_CODE	정상
01	APPLICATION_ERROR	어플리케이션 에러
02	DB_ERROR	DB에러
03	NODATA_ERROR	데이터 없음 에러
04	HTTP_ERROR	HTTP 에러
05	SERVICETIMEOUT_ERROR	서비스 연결실패 에러
10	INVALID_REQUEST_PARAMETER_ERROR	잘못된 요청 파라메터 에러
11	NO_MANDATORY_REQUEST_PARAMETERS_ERROR	필수요청 파라메터가 없음
12	NO_OPENAPI_SERVICE_ERROR	해당 오픈API서비스가 없거나 폐기됨
20	SERVICE_ACCESS_DENIED_ERROR	서비스 접근거부
21	TEMPORARILY_DISABLE_THE_SERVICEKEY_ERROR	일시적으로 사용할 수 없는 서비스 키
22	LIMITED_NUMBER_OF_SERVICE_REQUESTS_EXCEEDS_ERROR	서비스 요청제한횟수 초과에러
30	SERVICE_KEY_IS_NOT_REGISTERED_ERROR	등록되지 않은 서비스키
31	DEADLINE_HAS_EXPIRED_ERROR	기한만료된 서비스키
32	UNREGISTERED_IP_ERROR	등록되지 않은 IP주소
33	UNSIGNED_CALL_ERROR	서명되지 않은 호출
34	SERVICE_KEY_IS_EMPTY_ERROR	전달되지 않은 서비스키
35	DISABLE_THE_SERVICEKEY_ERROR	사용 중지된 서비스 키
99	UNKNOWN_ERROR	기타 에러