действие.устройства.ЗАПРОС

Это намерение запрашивает ваше выполнение для текущих состояний устройств, в том числе, находится ли устройство в сети и доступно.

Ваш ответ QUERY должен возвращать только информацию о состоянии. Обновление атрибутов и характеристик устройства обрабатывается ответом SYNC .

Дополнительные сведения см. в разделе Запрос и выполнение .

Формат запроса

Поля	Тип	Описание
requestId	Нить	Необходимый. ID запроса.
inputs	Множество	Необходимый. Список входных данных, соответствующих запросу намерения.
[ item, ... ]	Объект	Тип и полезные данные, связанные с запросом намерения.
intent		Необходимый. (Постоянное значение: "action.devices.QUERY" ) Тип запроса намерения.
payload	Объект	Необходимый. QUERY запрос полезной нагрузки.
devices	Множество	Необходимый. Список целевых устройств.
[ item, ... ]	Объект	Целевые устройства для запроса.
id	Нить	Необходимый. Идентификатор устройства в соответствии с идентификатором, предоставленным в SYNC.
customData	Объект	Если в SYNC предоставляется непрозрачный объект customData, он отправляется сюда.

Примеры

запрос намерения 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"
            }
          }
        ]
      }
    }
  ]
}

Формат ответа

Поля	Тип	Описание
requestId	Нить	Необходимый. ID соответствующего запроса.
payload	Объект	Необходимый. Полезная нагрузка ответа на намерение.
errorCode	Нить	Код ошибки для всей транзакции для сбоев аутентификации и недоступности системы разработчика. Для ошибок отдельных устройств используйте errorCode в объекте устройства.
debugString	Нить	Подробная ошибка, которая никогда не будет представлена ​​пользователям, но может быть зарегистрирована или использована во время разработки.
devices	Объект	Необходимый. Карта устройств. Сопоставляет идентификатор устройства разработчика с объектом свойств состояния.
<string>	Объект	Состояние устройства.
online	логический	Необходимый. Указывает, находится ли устройство в сети (то есть доступно) или нет.
status	Нить	Необходимый. Результат операции запроса. Поддерживаемые значения: SUCCESS Подтвердите, что запрос выполнен успешно. OFFLINE Целевое устройство находится в автономном режиме или недоступно. EXCEPTIONS Возникла проблема или предупреждение, связанное с запросом. Запрос может быть успешным или неудачным. Этот тип состояния обычно устанавливается, когда вы хотите отправить дополнительную информацию о другом подключенном устройстве. ERROR Не удалось запросить целевое устройство.
errorCode	Нить	Расширение состояния ERROR, если необходимо, из предустановленных кодов ошибок, которые будут отображаться в ошибках, представленных пользователям.

Примеры

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
        }
      }
    }
  }
}