DAMDA Docs
  • DAMDA Overview
  • Quick Start
    • 개발환경 구성하기
    • Hello DAMDA 따라하기
    • ThinQ 연결하기
    • 내 컴포넌트 로그 확인하기
    • 내 컴포넌트 원격 제어하기
  • FUNDAMENTALS
    • DAMDA 기기
      • DAMDA Installer
        • DAMDA Installer 설치하기
        • DAMDA 설치하기
        • DAMDA 삭제하기
        • DAMDA Installer 삭제하기
      • DAMDA Debugging Console
      • DAMDA Home
        • 기기 등록 하기
        • 기기 등록 해제하기
      • Custom Sub Device
        • Capability
        • Profile
        • Functions
    • DAMDA Cloud
      • 계정 관리
        • 계정 생성하기
        • 기타
      • 컴포넌트 관리
        • DAMDA Components
        • 컴포넌트 초기화하기
        • 컴포넌트 개발하기
        • 컴포넌트 생성하기
        • 컴포넌트 배포하기
    • DAMDA Tools
      • DAMDA CLI
        • Configuration
        • Component
        • Device
        • Deployment
      • DAMDA Simulator
  • REFERENCE
    • API Reference
      • ThinQ API
        • APIs
          • ThinQ 계정 등록
          • 사용자 홈 목록 가져오기
          • 사용자 기기 목록 가져오기
          • 기기 등록하기
          • 기기 정보 가져오기
          • 기기 제어하기
          • 기기 삭제하기
          • 기기 정보 전달하기
        • Error / Exceptions
      • Hub API
        • APIs
          • 지원 기기타입 가져오기
          • 기기 profile 가져오기
          • Capability 가져오기
          • 서브 디바이스 등록하기
          • 서브 디바이스 삭제하기
          • 등록 / 삭제 결과 확인하기
          • 서브 디바이스 리스트 조회
          • 서브 디바이스 정보 조회
          • 서브 디바이스 상태 조회
          • 서브 디바이스 제어
          • 제어 결과 확인
          • 서브 디바이스 상태 모니터링
          • 전체 서브 디바이스 상태 모니터링
        • Types
          • Device
          • DeviceState
      • 가전 API
        • 가전 상태 조회
        • 가전 제어
        • APIs
          • 공통 | Headers
          • 공통 | Response
          • 공통 | Error
          • 가전 목록 조회
          • 가전 상태 조회
          • 가전 Profile 조회
          • 가전 제어
          • EMP Access Token 발급
          • Event/Push Callback (Websocket)
        • Types
          • Device Type
          • Device Profile
      • webOS TV API
        • TV 리스트 조회
        • TV 등록
        • Custom SSAP Command
        • Control
          • ON/OFF
          • Channel
          • Audio
          • App
          • UI 및 기타
        • Remote
        • Subscribe
    • Samples
      • Hello DAMDA
      • ThinQ 연결하기
      • Debugging App
      • 가전 App
      • Proto Sub Device
      • TV화면 캡쳐 + AWS Rekognition
      • DAMDA Hub
Powered by GitBook
On this page
  1. REFERENCE
  2. API Reference
  3. 가전 API
  4. APIs

공통 | Headers

가전 API에서 공통적으로 사용하는 Header 정보입니다.

Name
Required
Description

Authorization

Mandatory

  • LG 회원 플랫폼(EMP)에서 사용자 인증을 위해 OAuth 표준에 따라 발급하는 토큰 값입니다.

  • 이 토큰을 이용하여 LG ThinQ 플랫폼은 어느 사용자의 디바이스 정보를 제공해야 하는지 식별하고, 서비스가 해당 사용자의 디바이스 정보를 이용하도록 승인 받았는지 확인합니다. Bearer {token}

x-country-code

Fixed

현재는 한국만 지원합니다. KR 로 고정하여 사용합니다.

  • 서비스를 제공할 국가를 지정할 수 있습니다.

  • 국가코드 ISO 3166-1 alpha-2를 사용합니다.

x-message-id

Option

  • ThinQ 플랫폼으로 요청되는 정보를 추적하기 위한 값 입니다. 특정 API의 흐름을 추적하고 에러 발생 시 원인을 찾을 수 있습니다.

  • 생성 규칙 - url-safe-base64-no-padding (UUID Version 4)방법으로 생성합니다. 길이는 22자입니다.

x-client-id

Mandatory

damda console의 DAMDA Key관리에서 발급 받은 connect key를 입력합니다.

x-client-secret

Mandatory

damda console의 DAMDA Key관리에서 발급 받은 connect secret을 입력합니다.

x-message-id 생성 예시 (Python)

import uuid
import base64

messageId = base64.urlsafe_b64encode(uuid.uuid4().bytes)[:-2]

Header Example

{
    "Authorization": "Bearer 5a9a713f51a95c53d781addd1af0dfa4f6e1e7420a8bff3c5198308dac571aa9845832b8d29bbe1f04deec2d35229c6d",
    "x-country-code": "KR",
    "x-message-id": "0123456789012345678912",
    "x-client-id": "abcde12345edfe",
    "x-client-secret": "cbdacbda12345677"
}
PreviousAPIsNext공통 | Response

Last updated 2 years ago

아래 를 참고해주세요

생성 예시