<aside> <img src="/icons/code_red.svg" alt="/icons/code_red.svg" width="40px" /> Lumi Labs API 레퍼런스 가이드 페이지에 오신 것을 환영합니다! 이 가이드에는 스마트 조명 생태계와 통합하는 데 필요한 툴과 정보가 포함되어 있습니다. API 엔드포인트, 요청/응답 형식, 인증 메커니즘, 오류 처리 및 모범 사례를 참고해 Lumi Labs의 잠재력을 최대한 활용해 보세요.

</aside>

시작하기

• API 키 받기
  • Lumi Labs API를 사용하려면 API 키가 필요합니다. 개발자 포털에서 개발자 계정을 등록하고 API 키를 생성하세요.
• 인증
  • Lumi Labs API는 인증을 위해 OAuth 2.0을 사용합니다. 모든 요청의 Authorization 헤더에 API 키를 포함하세요.
• 기본 URL
  • 모든 API 요청은 다음 기본 URL로 보내야 합니다: https://api.lumilabs.com

API 엔드포인트

• 조명 제어
  • GET /lights: 모든 등록된 조명 목록을 가져옵니다.
  • GET /lights/{lightId}: 특정 조명에 대한 정보를 가져옵니다.
  • PUT /lights/{lightId}/state: 조명의 상태(켜짐/꺼짐, 밝기, 색상 등)를 업데이트합니다.
  • POST /lights/{lightId}/effects: 특정 조명에 조명 효과를 적용합니다(예: 펄스, 스트로브)
• 장면 관리
  • GET /scenes: 생성된 모든 장면의 목록을 가져옵니다.
  • GET /scenes/{sceneId}: 특정 장면에 대한 정보를 가져옵니다.
  • POST /scenes: 새로운 장면을 생성합니다.
  • PUT /scenes/{sceneId}: 장면을 업데이트합니다.
  • DELETE /scenes/{sceneId}: 장면을 삭제합니다.
  • POST /scenes/{sceneId}/activate: 장면을 활성화합니다.
• 에너지 모니터링
  • GET /energy/usage: 모든 조명의 에너지 사용 통계를 가져옵니다.
  • GET /energy/usage/{lightId}: 특정 조명의 에너지 사용 통계를 가져옵니다.
• 추가 엔드포인트 (일정, 그룹 등)

요청 및 응답 형식

• 요청 형식
  • JSON 형식
• 응답 형식
  • JSON 형식

오류 처리

Lumi Labs API는 요청의 성공 또는 실패를 나타내기 위해 표준 HTTP 상태 코드를 사용합니다. 다음은 일반적인 오류 코드입니다.

• 400 Bad Request: 요청이 잘못되었거나 필수 매개변수가 누락되었습니다.
• 401 Unauthorized: API 키가 잘못되었거나 누락되었습니다.
• 403 Forbidden: 요청된 작업을 수행할 권한이 없습니다.