Overview

여러분의 DR 서비스를 LG 가전 사용자들에게 제공하려면 어떻게 해야 할까요? LG ThinQ 플랫폼은 파트너의 DR 서비스를 위한 인터페이스로 DR API를 제공합니다.

What is DR Service?

DR (Demand Response) 서비스는 현재 전력량의 수요에 맞추기 위해 특정 시간(피크 타임) 동안 사용자의 전력 사용을 줄이거나 변경시킬 수 있는 이벤트(DR Request)를 등록하여 사용자의 디바이스를 제어하는 서비스입니다. LG ThinQ 플랫폼은 LG 가전을 사용하는 사용자들을 대상으로 DR 서비스를 직접 운영하는 파트너(DR Service Provider)를 위해 Cloud-to-Cloud 인터페이스를 제공합니다. DR API (Application Programming Interface)는 RESTful API로 디자인되었으며, 다음 기능을 제공합니다. 

  • 사용자 등록/삭제
  • DR Request 등록/삭제
  • 디바이스 데이터 조회

Basic Concept

DR 서비스의 구조를 간략하게 설명하는 그림입니다.

여러분의 DR 서비스 서버와 LG DR 서비스 서버는 DR API를 통해 데이터를 주고받으며 DR 서비스 사용자의 디바이스를 제어할 수 있습니다.

DR Service에 대한 간략한 아키텍처

 

여러분의 DR 서비스는 DR API를 호출하여 다음과 같은 일들을 할 수 있습니다.

  • 사용자 정보를 등록하고 관리합니다.
  • 등록된 사용자의 사용 가능한 디바이스를 조회합니다. 
  • 가전 제어를 위한 DR Request를 등록합니다.
  • 주기적으로(15분 간격) 디바이스 상태를 로깅한 데이터를 파일로 생성합니다.

 

Pre-requisites

여러분의 DR 서비스는 아래의 조건을 모두 만족하는 사용자에게 제공할 수 있습니다.

  • LG 멤버십 서비스인 LG EMP(Enterprise Membership Platform)에 등록되어 있는 사용자
  • LG ThinQ 앱을 통해 Wi-Fi 기능을 지원하는 디바이스(LG 가전)를 등록한 사용자

 

DR Service Scenario

사용자는 디바이스를 LG ThinQ 앱을 사용하여 등록하고, 여러분의 사이트를 통해 DR 서비스에 가입해야 합니다.

DR API를 사용하여 여러분이 등록한 DR Request는 지정된 시작 시간의 1시간 전에 사용자에게 LG ThinQ 앱을 통해 미리 서비스 시작에 대한 알림을 줍니다.

DR Request는 지정된 시작 시간에 실행되고, 시작 시간 전/후 15분 간격으로 디바이스 상태를 모니터링하며 기록합니다. 여러분은 DR API를 사용하여 기록된 데이터를 파일로 생성하여 확인할 수 있습니다.

마지막으로 여러분은 사용자에게 사전에 안내한 내용에 따라 DR 서비스에 대한 정산을 하면 됩니다. 

01. 제품/서비스 등록

  • 사용자
    LG ThinQ 앱을 사용하여 디바이스를 등록합니다. 또한 파트너 사이트(홈페이지)에서 DR 서비스에 가입합니다.

02. DR Request 발령

  • 파트너
    DR 서비스를 시작하기 최소 1시간 전에 DR API를 통해 DR Request를 등록합니다.
     
  • LG DR 서비스 서버
    등록된 DR Request를 정해진 시작 시간에 타깃 디바이스에 전달합니다.
     
  • 사용자
    LG ThinQ 앱으로 DR 서비스가 1시간 후에 시작될 예정임을 알림으로 받습니다.

03. 상태 모니터링

  • LG DR 서비스 서버
    DR Request 실행을 시작하기 전/후 15분 간격으로 디바이스 상태를 모니터링하여 기록합니다.
     
  • 파트너
    LG DR 서비스 서버에 기록된 모니터링 데이터를 DR API를 통해 확인할 수 있습니다.

04. DR 서비스 정산

  • 파트너
    사용자의 DR 서비스 참여율에 따라 정산을 합니다. 정산에 대한 자세한 내용을 사용자에게 제공해주세요.

 

Terms and Definitions

DR API에서 공통적으로 사용되는 용어의 정의는 다음과 같습니다.

용어 정의

Terms

Description

DR

Demand Response

LG DR 서비스 서버

DR 서비스를 위해 사용자들과 해당 사용자들의 가전들을 관리하면서 가전들의 상태를 모니터링 및 제어하는 기능을 수행합니다. DR Request 처리 시, 각 파트너사가 요구하는 스펙에 맞게 DR 대응을 합니다.

파트너

LG 가전을 사용하는 사용자들을 대상으로 DR 서비스를 직접 운영하는 DR Service Provider입니다.

파트너 서버 (Partner Server)

파트너가 DR 서비스를 운영하고 있는 서버입니다. 예를 들면, 유틸리티사에서 운영하는 DR Program 용 서버가 있으며 DR 신호 등을 전달합니다. 

사용자 (END-User)

LG 가전을 사용하고 LG EMP에 등록되어 있는 고객이자, 파트너사에서 제공하는 DR 서비스에 가입한 고객입니다.

디바이스

사용자가 소유하고 있는 가전으로, LG ThinQ 플랫폼에 등록한 "LG 가전"을 의미합니다.

  • 디바이스 등록은 사용자가 직접 LG ThinQ 앱을 통해 해야 합니다.  

Service ID

서비스를 LG DR 서비스 서버와 연동 요청을 하면 전달되는 값으로, LG DR 서비스 서버에서 서비스 식별자로 사용됩니다.
서비스 개발자는 DR API에서 헤더 파라미터 중 하나인 x-service-id에 이 값을 넣어야 합니다.

Service Key

서비스를 LG DR 서비스 서버와 연동 요청을 하면 전달되는 값으로, LG DR 서비스 서버에서 서비스 식별자로 사용됩니다.
서비스 개발자는 DR API에서 헤더 파라미터 중 하나인 x-service-token에 이 값을 넣어야 합니다.