Compartir a través de


Philips HUE (Editor independiente)

Philips HUE le permite controlar dispositivos domésticos inteligentes, como luces, interruptores, enchufes y más construidos por Philips.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Tomasz Poszytek
URL https://aka.ms/poszytek
Correo Electrónico tomasz@poszytek.eu
Metadatos del conector
Publicador Tomasz Poszytek
Website https://www.philips-hue.com/
Directiva de privacidad https://www.philips-hue.com/en-us/support/legal/privacy-policy
Categorías Internet de las cosas; Estilo de vida y entretenimiento

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de aplicación HUE securestring Clave de API que se devuelve después de realizar llamadas de autorización PUT y POST. Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Amanecer

Obtenga detalles de un dispositivo específico que tenga funcionalidades de rayo.

Ejecutar dispositivo

Ejecute un dispositivo específico.

Ejecutar luz

Ejecute el dispositivo con funcionalidades de rayo.

Eliminar escena

Eliminar escena específica.

Obtención de dispositivos

Obtenga una lista de todos los dispositivos.

Obtener dispositivo

Obtenga detalles de un dispositivo específico.

Obtener escena

Obtenga detalles de una escena específica.

Obtener escenas

Obtenga una lista de todas las escenas. Las escenas se usan para almacenar y recuperar la configuración de un grupo de luces.

Obtener habitaciones

Obtiene la lista de salas (grupos).

Obtener luces

Obtenga una lista de los dispositivos que tienen funcionalidades de rayo.

Amanecer

Obtenga detalles de un dispositivo específico que tenga funcionalidades de rayo.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de dispositivo
DeviceId True string

Identificador de un dispositivo para mostrar los detalles.

Devoluciones

Nombre Ruta de acceso Tipo Description
Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

datos
data array of object

Luces que coinciden con el identificador especificado.

Valores de acción
data.alert.action_values array of string

Lista de efectos de alerta que admite la luz.

Azul X
data.color.gamut.blue.x float

Posición X en la gama de colores.

Azul Y
data.color.gamut.blue.y float

Posición Y en la gama de colores.

X verde
data.color.gamut.green.x float

Posición X en la gama de colores.

Verde Y
data.color.gamut.green.y float

Posición X en la gama de colores.

X rojo
data.color.gamut.red.x float

Posición X en la gama de colores.

Rojo Y
data.color.gamut.red.y float

Posición X en la gama de colores.

Tipo de gama
data.color.gamut_type string

Los tipos de gama admitidos por el matiz: A - Gama de productos tempranos de solo color Philips, B - Gama limitada de los primeros productos de color Hue, C - Gama de colores más rica de productos de color blanco y color de Hue, otros - Gama de colores de productos no hue.

X
data.color.xy.x float

Posición X en la gama de colores.

S
data.color.xy.y float

Posición Y en la gama de colores.

Mirek
data.color_temperature.mirek integer

Temperatura de color en mirek o null cuando el color claro no está en el espectro ct.

Mirek maximum
data.color_temperature.mirek_schema.mirek_maximum integer

Temperatura máxima del color que admite esta luz.

Mirek mínimo
data.color_temperature.mirek_schema.mirek_minimum integer

Temperatura de color mínima que admite esta luz.

Mirek válido
data.color_temperature.mirek_valid boolean

Indicación de si el valor presentado en mirek es válido.

Brillo
data.dimming.brightness float

Porcentaje de brillo. el valor no puede ser 0, escribir 0 cambia a un brillo más bajo posible.

Nivel mínimo de atenuación
data.dimming.min_dim_level float

Porcentaje del lúmen máximo que el dispositivo genera en el brillo mínimo.

Velocidad
data.dynamics.speed float

Velocidad de la paleta dinámica o efecto. La velocidad es válida para la paleta dinámica si el estado es dynamic_palette o para el efecto correspondiente enumerado en estado. En caso de estado ninguno, la velocidad no es válida.

Velocidad válida
data.dynamics.speed_valid boolean

Indica si el valor presentado en velocidad es válido.

Estado
data.dynamics.status string

Estado actual de la lámpara con dinámica.

Valores de estado
data.dynamics.status_values array of string

Estados en los que una lámpara podría ser al jugar dinámica.

Identificador de recurso
data.id string

Identificador único que representa una instancia de recurso específica.

Clip v1 resource id
data.id_v1 string

Clip v1 resource identifier (v1 API version).

Arquetipo
data.metadata.archetype string

Arquetipo claro. En desuso: use el arquetipo en el nivel de dispositivo.

Nombre proporcionado por el dispositivo
data.metadata.name string

Nombre legible de un recurso.

Mode
data.mode string

Uno de: normal o streaming.

Estado claro
data.on.on boolean

Estado Activado/Desactivado de la luz: on=true, off=false.

RID
data.owner.rid string

Identificador único del recurso al que se hace referencia.

Rtype
data.owner.rtype string

Tipo del recurso al que se hace referencia.

Tipo
data.type string

Tipo de los recursos admitidos.

Ejecutar dispositivo

Ejecute un dispositivo específico.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de dispositivo
DeviceId True string

Identificador de un dispositivo para actualizar los metadatos.

Arquetipo
archetype string

De forma predeterminada, el arquetipo proporcionado por el fabricante.

Nombre
name string

Nombre legible de un recurso (máximo de 32 caracteres).

Acción
action string

Escriba "identificar" para desencadenar la identificación. Bridge realiza ciclos de identificación led zigbee durante 5 segundos. Las luces realizan un ciclo de respiración. Los sensores realizan ciclos de identificación LED durante 15 segundos.

Devoluciones

Nombre Ruta de acceso Tipo Description
datos
data array of object

Dispositivos actualizados.

librar
data.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.rtype string

Tipo del recurso al que se hace referencia.

Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

Ejecutar luz

Ejecute el dispositivo con funcionalidades de rayo.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de dispositivo
DeviceId True string

Identificador de un dispositivo para actualizar las propiedades.

Nombre
name string

MinLength: 1 - maxLength: 32. Nombre legible de un recurso.

Por
on boolean

Estado Activado/Desactivado de la luz on=true, off=false.

Brillo
brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Mirek
mirek integer

Mínimo: 153 - máximo: 500. Temperatura de color en mirek o null cuando el color claro no está en el espectro ct.

X
x float

Mínimo: 0 - máximo: 1. Posición X en la gama de colores.

S
y float

Mínimo: 0 - máximo: 1. Posición Y en la gama de colores.

Velocidad
speed float

Mínimo: 0 - máximo: 1. Velocidad de la paleta dinámica. La velocidad es válida para la paleta dinámica si el estado es dynamic_palette o para el efecto correspondiente enumerado en estado. En caso de estado ninguno, la velocidad no es válida.

Duración
duration integer

Máximo: 6000000. Duración de una transición ligera en ms. La precisión está en 100 ms.

Acción
action string

Una de las acciones disponibles para ejecutarse en un dispositivo. Es decir, "respira".

X
x float

Mínimo: 0 - máximo: 1. Posición X en la gama de colores.

S
y float

Mínimo: 0 - máximo: 1. Posición Y en la gama de colores.

Devoluciones

Nombre Ruta de acceso Tipo Description
datos
data array of object

datos

librar
data.rid string

librar

rtype
data.rtype string

rtype

Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

Eliminar escena

Eliminar escena específica.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de escena
SceneId True string

Identificador de una escena que se va a eliminar.

Devoluciones

Nombre Ruta de acceso Tipo Description
datos
data array of object

Escenas actualizadas.

librar
data.rid string

Identificador único de la escena eliminada.

rtype
data.rtype string

Tipo de la escena eliminada.

Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

Obtención de dispositivos

Obtenga una lista de todos los dispositivos.

Devoluciones

Nombre Ruta de acceso Tipo Description
Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

datos
data array of object

Dispositivos de usuario.

Id
data.id string

Identificador único que representa una instancia de recurso específica.

Id. v1
data.id_v1 string

Clip v1 resource identifier (to be used in API v1).

Arquetipo
data.metadata.archetype string

Arquetipo predeterminado proporcionado por el fabricante.

Nombre
data.metadata.name string

Nombre legible de un recurso.

Certificado
data.product_data.certified boolean

Este dispositivo está certificado por HUE.

Nombre del fabricante
data.product_data.manufacturer_name string

Nombre del fabricante del dispositivo.

Id. de modelo
data.product_data.model_id string

identificación única del modelo de dispositivo.

Arquetipo de producto
data.product_data.product_archetype string

Arquetipo del producto.

Nombre del producto
data.product_data.product_name string

Nombre del producto.

Versión del software
data.product_data.software_version string

Versión de software del producto.

Services
data.services array of object

Hace referencia a todos los servicios que agregan el control y el estado de los elementos secundarios del grupo.

librar
data.services.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.services.rtype string

Tipo del recurso al que se hace referencia.

Tipo
data.type string

Tipo del recurso admitido.

Obtener dispositivo

Obtenga detalles de un dispositivo específico.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de dispositivo
DeviceId True string

Identificador de un dispositivo para mostrar los detalles.

Devoluciones

Nombre Ruta de acceso Tipo Description
Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

datos
data array of object

Dispositivos que coinciden con el identificador especificado.

Id
data.id string

Identificador único que representa una instancia de recurso específica.

Id. v1
data.id_v1 string

Clip v1 resource identifier (to be used in API v1).

Arquetipo
data.metadata.archetype string

Arquetipo predeterminado proporcionado por el fabricante.

Nombre
data.metadata.name string

Nombre legible de un recurso.

Certificado
data.product_data.certified boolean

Este dispositivo está certificado por HUE.

Nombre del fabricante
data.product_data.manufacturer_name string

Nombre del fabricante del dispositivo.

Id. de modelo
data.product_data.model_id string

identificación única del modelo de dispositivo.

Arquetipo de producto
data.product_data.product_archetype string

Arquetipo del producto.

Nombre del producto
data.product_data.product_name string

Nombre del producto.

Versión del software
data.product_data.software_version string

Versión de software del producto.

Services
data.services array of object

Hace referencia a todos los servicios que agregan el control y el estado de los elementos secundarios del grupo.

librar
data.services.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.services.rtype string

Tipo del recurso al que se hace referencia.

Tipo
data.type string

Tipo del recurso admitido.

Obtener escena

Obtenga detalles de una escena específica.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de escena
SceneId True string

Identificador de una escena para mostrar los detalles.

Devoluciones

Nombre Ruta de acceso Tipo Description
Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

datos
data array of object

Datos

Acciones
data.actions array of object

Lista de acciones ejecutadas en la escena.

X
data.actions.action.color.xy.x float

Mínimo: 0 - máximo: 1. Posición X en la gama de colores.

S
data.actions.action.color.xy.y float

Mínimo: 0 - máximo: 1. Posición Y en la gama de colores.

Brillo
data.actions.action.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Por
data.actions.action.on.on boolean

Estado Activado/Desactivado de la luz on=true, off=false.

Mirek
data.actions.action.color_temperature.mirek integer

Mínimo: 153 - máximo: 500. Temperatura de color en mirek o null cuando el color claro no está en el espectro ct.

librar
data.actions.target.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.actions.target.rtype string

Tipo del recurso al que se hace referencia.

librar
data.group.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.group.rtype string

Tipo del recurso al que se hace referencia.

Id
data.id string

Identificador único que representa una instancia de recurso específica.

Id. v1
data.id_v1 string

Clip v1 resource identifier (to be used in API v1).

librar
data.metadata.image.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.metadata.image.rtype string

Tipo del recurso al que se hace referencia.

Nombre
data.metadata.name string

Nombre legible de un recurso.

Color
data.palette.color array of object
X
data.palette.color.color.xy.x float

Mínimo: 0 - máximo: 1. Posición X en la gama de colores.

S
data.palette.color.color.xy.y float

Mínimo: 0 - máximo: 1. Posición Y en la gama de colores.

Brillo
data.palette.color.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Temperatura del color
data.palette.color_temperature array of object
Mirek
data.palette.color_temperature.color_temperature.mirek integer

Mínimo: 153 - máximo: 500. Temperatura de color en mirek o null cuando el color claro no está en el espectro ct.

Brillo
data.palette.color_temperature.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Atenuación
data.palette.dimming array of object
Brillo
data.palette.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Velocidad
data.speed float

Velocidad de la paleta dinámica para esta escena.

Tipo
data.type string

Tipo de los recursos admitidos.

Obtener escenas

Obtenga una lista de todas las escenas. Las escenas se usan para almacenar y recuperar la configuración de un grupo de luces.

Devoluciones

Nombre Ruta de acceso Tipo Description
Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

datos
data array of object

Datos

Acciones
data.actions array of object

Lista de acciones ejecutadas en la escena.

X
data.actions.action.color.xy.x float

Mínimo: 0 - máximo: 1. Posición X en la gama de colores.

S
data.actions.action.color.xy.y float

Mínimo: 0 - máximo: 1. Posición Y en la gama de colores.

Brillo
data.actions.action.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Por
data.actions.action.on.on boolean

Estado Activado/Desactivado de la luz on=true, off=false.

Mirek
data.actions.action.color_temperature.mirek integer

Mínimo: 153 - máximo: 500. Temperatura de color en mirek o null cuando el color claro no está en el espectro ct.

librar
data.actions.target.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.actions.target.rtype string

Tipo del recurso al que se hace referencia.

librar
data.group.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.group.rtype string

Tipo del recurso al que se hace referencia.

Id
data.id string

Identificador único que representa una instancia de recurso específica.

Id. v1
data.id_v1 string

Clip v1 resource identifier (to be used in API v1).

librar
data.metadata.image.rid string

Identificador único del recurso al que se hace referencia.

rtype
data.metadata.image.rtype string

Tipo del recurso al que se hace referencia.

Nombre
data.metadata.name string

Nombre legible de un recurso.

Color
data.palette.color array of object
X
data.palette.color.color.xy.x float

Mínimo: 0 - máximo: 1. Posición X en la gama de colores.

S
data.palette.color.color.xy.y float

Mínimo: 0 - máximo: 1. Posición Y en la gama de colores.

Brillo
data.palette.color.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Temperatura del color
data.palette.color_temperature array of object
Mirek
data.palette.color_temperature.color_temperature.mirek integer

Mínimo: 153 - máximo: 500. Temperatura de color en mirek o null cuando el color claro no está en el espectro ct.

Brillo
data.palette.color_temperature.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Atenuación
data.palette.dimming array of object
Brillo
data.palette.dimming.brightness float

Máximo: 100. Porcentaje de brillo. Escribir 0 cambia a menor brillo posible.

Velocidad
data.speed float

Velocidad de la paleta dinámica para esta escena.

Tipo
data.type string

Tipo de los recursos admitidos.

Obtener habitaciones

Obtiene la lista de salas (grupos).

Devoluciones

Nombre Ruta de acceso Tipo Description
Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

datos
data array of object

Datos

Secundarios
data.children array of object

Dispositivos que se van a agrupar por la sala. Se permiten los siguientes elementos secundarios: "dispositivo".

librar
data.children.rid string

Identificador único de la escena creada.

rtype
data.children.rtype string

Tipo de la escena creada.

Servicios agrupados
data.grouped_services array of object

Referencias a servicios de control agregados. En desuso: use servicios.

librar
data.grouped_services.rid string

Identificador único de la escena creada.

rtype
data.grouped_services.rtype string

Tipo de la escena creada.

Id
data.id string

Identificador único que representa una instancia de recurso específica.

Id. v1
data.id_v1 string

Clip v1 resource identifier (to be used in API v1).

Arquetipo
data.metadata.archetype string

Arquetipo predeterminado proporcionado por el fabricante.

Nombre
data.metadata.name string

Nombre legible de un recurso.

Services
data.services array of object

Hace referencia a todos los servicios que agregan el control y el estado de los elementos secundarios del grupo. La agregación es por tipo de servicio, es decir, cada tipo de servicio que se puede agrupar tiene una definición correspondiente del tipo agrupado. Tipos admitidos: "light".

librar
data.services.rid string

Identificador único de la escena creada.

rtype
data.services.rtype string

Tipo de la escena creada.

Tipo
data.type string

Tipo de los recursos admitidos.

Obtener luces

Obtenga una lista de los dispositivos que tienen funcionalidades de rayo.

Devoluciones

Nombre Ruta de acceso Tipo Description
Errores
errors array of object

Errores que se produjeron durante la llamada.

Descripción del error
errors.description string

Una explicación legible específica de esta aparición del problema.

datos
data array of object

Luces del usuario.

Valores de acción
data.alert.action_values array of string

Lista de efectos de alerta que admite la luz.

Azul X
data.color.gamut.blue.x float

Posición X en la gama de colores.

Azul Y
data.color.gamut.blue.y float

Posición Y en la gama de colores.

X verde
data.color.gamut.green.x float

Posición X en la gama de colores.

Verde Y
data.color.gamut.green.y float

Posición X en la gama de colores.

X rojo
data.color.gamut.red.x float

Posición X en la gama de colores.

Rojo Y
data.color.gamut.red.y float

Posición X en la gama de colores.

Tipo de gama
data.color.gamut_type string

Los tipos de gama admitidos por el matiz: A - Gama de productos tempranos de solo color Philips, B - Gama limitada de los primeros productos de color Hue, C - Gama de colores más rica de productos de color blanco y color de Hue, otros - Gama de colores de productos no hue.

X
data.color.xy.x float

Posición X en la gama de colores.

S
data.color.xy.y float

Posición Y en la gama de colores.

Mirek
data.color_temperature.mirek integer

Temperatura de color en mirek o null cuando el color claro no está en el espectro ct.

Mirek maximum
data.color_temperature.mirek_schema.mirek_maximum integer

Temperatura máxima del color que admite esta luz.

Mirek mínimo
data.color_temperature.mirek_schema.mirek_minimum integer

Temperatura de color mínima que admite esta luz.

Mirek válido
data.color_temperature.mirek_valid boolean

Indicación de si el valor presentado en mirek es válido.

Brillo
data.dimming.brightness float

Porcentaje de brillo. el valor no puede ser 0, escribir 0 cambia a un brillo más bajo posible.

Nivel mínimo de atenuación
data.dimming.min_dim_level float

Porcentaje del lúmen máximo que el dispositivo genera en el brillo mínimo.

Velocidad
data.dynamics.speed float

Velocidad de la paleta dinámica o efecto. La velocidad es válida para la paleta dinámica si el estado es dynamic_palette o para el efecto correspondiente enumerado en estado. En caso de estado ninguno, la velocidad no es válida.

Velocidad válida
data.dynamics.speed_valid boolean

Indica si el valor presentado en velocidad es válido.

Estado
data.dynamics.status string

Estado actual de la lámpara con dinámica.

Valores de estado
data.dynamics.status_values array of string

Estados en los que una lámpara podría ser al jugar dinámica.

Identificador de recurso
data.id string

Identificador único que representa una instancia de recurso específica.

Clip v1 resource id
data.id_v1 string

Clip v1 resource identifier (v1 API version).

Arquetipo
data.metadata.archetype string

Arquetipo claro. En desuso: use el arquetipo en el nivel de dispositivo.

Nombre proporcionado por el dispositivo
data.metadata.name string

Nombre legible de un recurso.

Mode
data.mode string

Uno de: normal o streaming.

Estado claro
data.on.on boolean

Estado Activado/Desactivado de la luz: on=true, off=false.

RID
data.owner.rid string

Identificador único del recurso al que se hace referencia.

Rtype
data.owner.rtype string

Tipo del recurso al que se hace referencia.

Tipo
data.type string

Tipo de los recursos admitidos.