오늘은 LG전자가 공식적으로 제공하는 개발자 API와 PAT(Personal Access Token)를 이용하여 홈어시스턴트와 LG ThinQ를 연동하는 방법에 대해 상세히 안내해 드리겠습니다.
LG 개발자 포털에서 PAT 발급받기#
가장 먼저, LG ThinQ 서버에 접근할 수 있는 권한을 가진 우리만의 고유한 열쇠, 즉 PAT를 발급받아야 합니다.
LG ThinQ Developer 포털 접속:#
웹 브라우저를 열어 아래 주소로 이동한 뒤, 일반 LG 계정으로 로그인합니다.
메뉴에서 [적용 가이드] - [마이 커넥트(개인 API)] 를 선택합니다.
PAT 발급하기:#
[PAT] 버튼을 선택하면 다시 한번 로그인 과정을 거치고 PAT 발급 화면으로 이동합니다.
권한 범위를 선택하고 [토큰 만들기]를 선택해서 토큰을 생성합니다.
생성된 PAT 우측의 복사 아이콘을 눌러 토큰 전체를 복사합니다.
홈어시스턴트에 연동 정보 설정하기#
이제 발급받은 PAT를 홈어시스턴트에 설정할 차례입니다. 이 과정은 PAT를 지원하는 커스텀 컴포넌트를 사용해야 합니다.
(주의: 현재 HACS의 대표적인 ThinQ 컴포넌트는 LG 계정 로그인을 우선 지원합니다. PAT 방식을 위해서는 해당 컴포넌트가 PAT 입력을 지원하는지 확인하거나, RESTful API 센서 등을 이용한 수동 설정이 필요할 수 있습니다. 여기서는 PAT 입력을 지원하는 가상의 통합 구성요소를 기준으로 설명합니다.)
통합 구성요소 추가:
[설정] > [기기 및 서비스] 로 이동하여 [+ 통합 구성요소 추가] 버튼을 누릅니다.
LG ThinQ 선택:
설정 창이 나타나면, 인증 정보를 입력합니다.
개인 엑세스 토큰(Personal Access Token) 에 이전 단계에서 복사해 둔 PAT 값 을 여기에 붙여넣습니다.
인증이 성공하면, 홈어시스턴트가 PAT를 통해 여러분의 LG 계정에 등록된 기기 목록을 가져와 시스템에 자동으로 추가합니다.
연동 후 활용#
모든 과정이 끝나면, 여러분의 LG 스마트 가전은 홈어시스턴트의 엔티티(Entity)가 되어 다른 스마트 기기들과 똑같이 제어하고 자동화에 활용할 수 있게 됩니다. 공식 API를 사용하므로, 상태 업데이트가 빠르고 제어 명령의 신뢰도가 높다는 장점을 체감하실 수 있을 겁니다.
마무리하며#
LG 개발자 포털을 이용한 PAT 방식의 연동은 간편하게 LG 디바이스와 홈어시스턴트를 연동해 주고, 기기들을 사용할 수 있게 해줍니다.