API Endpoints Intro
The Philips Hue integration uses the Philips Hue REST API. Light and group commands are sent to your Bridge through the Hue cloud, using a base URL that includes your authenticated Bridge user:
Base URL: https://api.meethue.com/bridge/{Hue Bridge User}
{Hue Bridge User} is filled in automatically when you authenticate the subscription (see Philips Hue Connections and Settings). The authorization endpoints below use the https://api.meethue.com host directly, without the /bridge/{Hue Bridge User} segment.
Areas covered: Light Endpoints · Group Endpoints · Authorization Endpoints
Light Endpoints
Get all Lights (GET)
[Base URL]/lights
Get a Light by Id (GET)
[Base URL]/lights/{id}
Update Light State (PUT)
[Base URL]/lights/{id}/state
Used to apply a light command (for example, a flash) to a specific light.
Group Endpoints
Get all Groups (GET)
[Base URL]/groups
Update Group Action (PUT)
[Base URL]/groups/{id}/action
Used to apply a light command to a Hue group.
Authorization Endpoints
Philips Hue uses OAuth. These endpoints are called on the https://api.meethue.com host during authentication and token renewal.
Get Access Token (POST)
https://api.meethue.com/oauth2/token
Refresh Access Token (POST)
https://api.meethue.com/oauth2/refresh
Register a Bridge Application (POST)
https://api.meethue.com/bridge
Called during the initial connection to authorize iPaaS.com with your Hue Bridge.
Configure the Bridge (PUT)
https://api.meethue.com/bridge/0/config
Called during the initial connection to complete the Bridge authorization.
Related Documents
