action.devices.QUERY
Este intent consulta tu entrega para los estados actuales de los dispositivos, incluso si el dispositivo está en línea y es accesible.
Tu respuesta QUERY
solo debe mostrar información de estado.
La respuesta SYNC
controla la actualización de los atributos y las características del dispositivo.
Para obtener más detalles, consulta Cómo ejecutar y consultar.
Formato de la solicitud
Campos | Tipo | Descripción |
---|---|---|
requestId |
String |
Obligatorio. ID de la solicitud. |
inputs |
Matriz |
Obligatorio. Lista de entradas que coinciden con la solicitud del intent. |
[item, ...] |
Objeto |
Tipo y carga útil asociadas con la solicitud de intent |
intent |
Obligatorio. (Valor de la constante: Tipo de solicitud de intent. |
|
payload |
Objeto |
Obligatorio. Carga útil de solicitud de QUERY |
devices |
Matriz |
Obligatorio. Lista de dispositivos de destino. |
[item, ...] |
Objeto |
Orientaciones del dispositivo que se consultarán. |
id |
String |
Obligatorio. ID del dispositivo, según el ID proporcionado en SYNC. |
customData |
Objeto |
Si el objeto customData opaco se proporciona en SYNC, se envía aquí. |
Ejemplos
Solicitud de intent QUERY
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123", "customData": { "fooValue": 74, "barValue": true, "bazValue": "foo" } }, { "id": "456", "customData": { "fooValue": 12, "barValue": false, "bazValue": "bar" } } ] } } ] }
Formato de la respuesta
Campos | Tipo | Descripción |
---|---|---|
requestId |
String |
Obligatorio. ID de la solicitud correspondiente. |
payload |
Objeto |
Obligatorio. Carga útil de respuesta de intent. |
errorCode |
String |
Un código de error de toda la transacción para fallas de autenticación y falta de disponibilidad del sistema para desarrolladores Para errores de dispositivos individuales, usa el errorCode dentro del objeto del dispositivo. |
debugString |
String |
Es un error detallado que nunca se presentará a los usuarios, pero que se podrá registrar o usar durante el desarrollo. |
devices |
Objeto |
Obligatorio. Mapa de dispositivos Asigna el ID de dispositivo del desarrollador al objeto de las propiedades de estado. |
<string> |
Objeto |
Estado del dispositivo. |
online |
Booleano |
Obligatorio. Indica si el dispositivo está en línea (es decir, si se puede acceder a él) o no. |
status |
String |
Obligatorio. Resultado de la operación de consulta. Valores admitidos:
|
errorCode |
String |
Expande el estado ERROR si es necesario a partir de los códigos de error predeterminados, que se asignarán a los errores que se presentan a los usuarios. |
Ejemplos
Respuesta del intent de QUERY
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "devices": { "123": { "on": true, "online": true, "status": "SUCCESS" }, "456": { "on": true, "online": true, "status": "SUCCESS", "brightness": 80, "color": { "spectrumRgb": 16711935 } } } } }