Get a light

GET /clip/v2/resource/light/light_uuid

Get a light by UUID, including its current state and supported features.

Example response

{
  "code": 0,
  "data": {
    "arr": [],
    "obj": {
            "ability": 79,
            "brightness": 100,
            "color_arr": [],
            "color_cw": 2740,
            "color_len": 0,
            "color_mode": 2,
            "color_rgb": 0,
            "color_rgb_arr": [],
            "color_x": 0,
            "color_y": 0,
            "ext_attr": {
                "motion": 2
            },
            "id": "49F6A5DD-F8FA-4617-9AE1-5F91D0E6E7EF",
            "motion": {},
            "motion_type": [
                1
            ],
            "name": "",
            "on": 1,
            "pack": [],
            "position_x": 0,
            "position_y": 0,
            "positions": "",
            "power_on": {
                "brightness": 0,
                "brightness_mode": 0,
                "color_cw": 0,
                "color_mode": 0,
                "color_x": 0,
                "color_y": 0,
                "mode": 0,
                "on": 0,
                "on_mode": 0
            },
            "support_dynamic": 0,
            "support_segment": 0,
            "sync_status": 0,
            "type": "light"
    }
  },
  "msg": "success"
}

Responses

Status code	Meaning
200	OK

Response fields

HTTP 200 OK

Field	Type	Required	Description
code	integer	Yes	Status code
msg	string	Yes	Message
data	object	Yes	Response payload.
data.obj	object	Yes	Returned resource.
data.obj.id	string	Yes	Light UUID
data.obj.type	string	Yes	Always light.
data.obj.name	string	Yes	Name
data.obj.on	integer	Yes	On/off state
data.obj.brightness	integer	Yes	Brightness, from 1 to 100.
data.obj.color_mode	integer	Yes	Color mode. 0: HSV color; 1: XY color; 2: color temperature; 3: multi-segment XY color.
data.obj.color_cw	integer	Yes	Color temperature, from 2000 to 6500.
data.obj.color_x	integer	Yes	X coordinate in the XY color space.
data.obj.color_y	integer	Yes	Y coordinate in the XY color space.
data.obj.color_len	integer	Yes	Number of individually controlled light segments.
data.obj.color_arr	object[]	Yes	Segment data
data.obj.color_arr[].x	integer	Yes	X coordinate
data.obj.color_arr[].y	integer	Yes	Y coordinate
data.obj.pack	string[]	No	For BweeApp use only.
data.obj.position_x	integer	No	For BweeApp use only.
data.obj.position_y	integer	No	For BweeApp use only.
data.obj.positions	string	Yes	For BweeApp use only.
data.obj.power_on	PowerOn	No	Power-on behavior
data.obj.power_on.mode	integer	Yes	Mode. 0: default; 1: restore previous state; 2: custom; 3: on; 4: off.
data.obj.power_on.on_mode	integer	Yes	On/off mode. 0: default; 1: restore previous state; 2: custom.
data.obj.power_on.on	integer	Yes	On/off state
data.obj.power_on.brightness_mode	integer	Yes	Brightness mode. 0: default; 1: restore previous state; 2: custom.
data.obj.power_on.brightness	integer	Yes	Brightness, from 0 to 100.
data.obj.power_on.color_mode	integer	Yes	Color mode. 0: default; 1: restore previous state; 2: custom XY; 3: custom color temperature.
data.obj.power_on.color_x	integer	Yes	Color X coordinate
data.obj.power_on.color_y	integer	Yes	Color Y coordinate
data.obj.power_on.color_cw	integer	Yes	Color temperature, from 2000 to 6500.
data.obj.support_segment	integer	Yes	1 if the light supports segmented color; otherwise 0.
data.obj.support_dynamic	integer	Yes	1 if dynamic scenes are supported; otherwise 0.
data.obj.ability	integer	Yes	Supported features, encoded as the bitmask described below.

Read ability as a bitmask: a set bit (1) means the light supports that feature; a cleared bit (0) means it does not.

Bit (n)	Binary value	Weight (2ⁿ)	Description
0	1	1	On/off control.
1	1	2	Brightness adjustment.
2	1	4	Color temperature control.
3	1	8	Color control.
4	1	16	Segmented lighting.
5	1	32	Light length configuration.
6	1	64	Dynamic effects.
7	1	128	Current adjustment.

For example, ability = 15 (0000 1111 in binary) enables bits 0-3: on/off control, brightness, color temperature, and color.