What is this?

This is a repository in which I store information on controlling my Phillips Hue lights

Getting started:

1. Connect Hue to router

2. Press link button to connect it to your Hue lights

3. Get IP address for Hue Bridge, easy way: www.meethue.com/api/nupnp

4. Press the link button again and POST on http://<bridge_ip>/api with body:

   {
     "devicetype":"your_device_type"
   }

   This will respond with an authorized username:

   [
     {
       "success": {
          "username": "some_username"
       }
     }
   ]

5. GET on /api/<username> will respond with all information on the linked Bridge.

6. GET on /api/<username>/lights will respond with only the information on the connected lights.

7. GET on /api/<username>/ligths/<index> will respond with only the information on the ligth with the relevant index.

8. Updating the state of a light can be done by PUTing on /api/<username>/lights/<index>/state, e.g. to turn a light off just PUT with the body

   {
      "on":false
   }

   The schema of state is as follows:

   {
     "state": {
       "on": "boolean",
       "bri": "int: 0 .. 254",
       "hue": "int 0 .. 65535",
       "sat": "int 0 .. 254",
       "effect": "string",
       "xy": [
    	   "double",
    	   "double"
       ],
       "ct": "int",
       "alert": "string",
       "colormode": "string",
       "reachable": "boolean"
     }
   }

More on the Hue API can be found here