1.0.0 • Published 1 year ago

open-hue v1.0.0

Weekly downloads
-
License
Apache 2.0
Repository
-
Last release
1 year ago

OpenHue TypeScript SDK 1.0.0

Welcome to the OpenHue SDK documentation. This guide will help you get started with integrating and using the OpenHue SDK in your project.

Versions

  • API version: v2
  • SDK version: 1.0.0

About the API

See openhue/openhue-api

Table of Contents

Setup & Configuration

Supported Language Versions

This SDK is compatible with the following versions: TypeScript >= 4.8.4

Installation

To get started with the SDK, we recommend installing using npm:

npm install open-hue

Authentication

API Key Authentication

The OpenHue API uses API keys as a form of authentication. An API key is a unique identifier used to authenticate a user, developer, or a program that is calling the API.

Setting the API key

When you initialize the SDK, you can set the API key as follows:

const sdk = new OpenHue({ apiKey: 'YOUR_API_KEY' });

If you need to set or update the API key after initializing the SDK, you can use:

const sdk = new OpenHue();
sdk.apiKey = 'YOUR_API_KEY';

Services

The SDK provides various services to interact with the API.

Name
AuthService
ResourceService
DeviceService
DevicePowerService
LightService
LightLevelService
MotionService
GroupedLightService
BridgeService
BridgeHomeService
SceneService
RoomService
ZoneService
TemperatureService

Models

The SDK includes several models that represent the data structures used in API requests and responses. These models help in organizing and managing the data efficiently.

NameDescription
AuthenticateRequest
Response
GetResourcesOkResponse
GetDevicesOkResponse
GetDeviceOkResponse
DevicePut
UpdateDeviceOkResponse
DeleteDeviceOkResponse
GetDevicePowersOkResponse
GetDevicePowerOkResponse
GetLightsOkResponse
GetLightOkResponse
LightPut
UpdateLightOkResponse
GetLightLevelsOkResponse
GetLightLevelOkResponse
LightLevelPut
UpdateLightLevelOkResponse
GetMotionSensorsOkResponse
GetMotionSensorOkResponse
MotionPut
UpdateMotionSensorOkResponse
GetGroupedLightsOkResponse
GetGroupedLightOkResponse
GroupedLightPut
UpdateGroupedLightOkResponse
GetBridgesOkResponse
GetBridgeOkResponse
BridgePut
UpdateBridgeOkResponse
GetBridgeHomesOkResponse
GetBridgeHomeOkResponse
GetScenesOkResponse
ScenePost
CreateSceneOkResponse
GetSceneOkResponse
ScenePut
UpdateSceneOkResponse
DeleteSceneOkResponse
GetRoomsOkResponse
RoomPut
CreateRoomOkResponse
GetRoomOkResponse
UpdateRoomOkResponse
DeleteRoomOkResponse
GetZonesOkResponse
CreateZoneOkResponse
GetZoneOkResponse
UpdateZoneOkResponse
DeleteZoneOkResponse
GetTemperaturesOkResponse
GetTemperatureOkResponse
TemperaturePut
UpdateTemperatureOkResponse
Success
ResponseError
Error
ResourceGet
ResourceGetTypeType of the supported resources
ResourceIdentifier
RtypeThe type of the referenced resource
DeviceGet
DeviceGetType
ProductData
DeviceGetMetadata
DeviceGetUsertest
ProductArchetypeThe default archetype given by manufacturer. Can be changed by user.
UsertestStatus
DevicePutType
DevicePutMetadata
Identify
DevicePutUsertest
IdentifyActionTriggers a visual identification sequence, current implemented as (which can change in the future): Bridge performs Zigbee LED identification cycles for 5 seconds Lights perform one breathe cycle Sensors perform LED identification cycles for 15 seconds
DevicePowerGet
PowerState
BatteryStateStatus of the power source of a device, only for battery powered devices. - normal – battery level is sufficient - low – battery level low, some features (e.g. software update) might stop working, please change battery soon - critical – battery level critical, device can fail any moment
LightGet
LightGetMetadataDeprecated, use metadata on device level
On
LightGetDimming
LightGetColorTemperature
LightGetColor
LightGetDynamics
LightGetSignalingFeature containing signaling properties.
LightGetMode
LightGetGradient
LightGetEffectsBasic feature containing effect properties.
LightGetTimedEffectsBasic feature containing timed effect properties.
LightGetPowerupFeature containing properties to configure powerup behaviour of a lightsource.
LightArchetypeLight archetype
MirekSchema
GamutPositionCIE XY gamut position
GamutColor gamut of color bulb. Some bulbs do not properly return the Gamut information. In this case this is not present.
GamutTypeThe gammut types supported by hue – A Gamut of early Philips color-only products – B Limited gamut of first Hue color products – C Richer color gamut of Hue white and color ambiance products – other Color gamut of non-hue products with non-hue gamuts resp w/o gamut
SupportedDynamicStatusCurrent status of the lamp with dynamics.
SupportedSignalsIndicates which signal is currently active.
Color
SupportedGradientModeMode in which the points are currently being deployed. If not provided during PUT/POST it will be defaulted to interpolated_palette
SupportedEffects
SupportedTimedEffectsCurrent status values the light is in regarding timed effects
PowerupPreset1When setting the custom preset the additional properties can be set. For all other presets, no other properties can be included.
1.0.0

1 year ago