action.devices.QUERY

Questo intent esegue una query sull'evasione degli ordini per conoscere gli stati attuali dei dispositivi, inclusa l'eventuale presenza online e raggiungibile.

La risposta QUERY dovrebbe restituire solo informazioni sullo stato. L'aggiornamento degli attributi e dei tratti del dispositivo è gestito dall' Risposta SYNC.

Per maggiori dettagli, consulta Eseguire query ed eseguire.

Formato della richiesta

Campi Tipo Descrizione
requestId String

Obbligatorio.

ID della richiesta.

inputs Array

Obbligatorio.

Elenco di input corrispondenti alla richiesta di intent.

[item, ...] Oggetto

Tipo e payload associati alla richiesta di intent.

intent

Obbligatorio.

(Valore costante: "action.devices.QUERY")

Tipo di richiesta di intent.

payload Oggetto

Obbligatorio.

Payload della richiesta QUERY.

devices Array

Obbligatorio.

Elenco dei dispositivi di destinazione.

[item, ...] Oggetto

Target per dispositivo su cui eseguire query.

id String

Obbligatorio.

ID dispositivo, come per l'ID fornito in SYNC.

customData Oggetto

Se l'oggetto customData opaco viene fornito in SYNC, viene inviato qui.

Esempi

Richiesta di intent di 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 della risposta

Campi Tipo Descrizione
requestId String

Obbligatorio.

ID della richiesta corrispondente.

payload Oggetto

Obbligatorio.

Payload della risposta dell'intent.

errorCode String

Un codice di errore per l'intera transazione per errori di autenticazione e mancata disponibilità del sistema degli sviluppatori. Per i singoli errori del dispositivo, utilizza il codice errorCode all'interno dell'oggetto dispositivo.

debugString String

Errore dettagliato che non verrà mai mostrato agli utenti, ma potrebbe essere registrato o utilizzato durante lo sviluppo.

devices Oggetto

Obbligatorio.

Mappa dei dispositivi. Mappa l'ID dispositivo sviluppatore all'oggetto delle proprietà dello stato.

<string> Oggetto

Stato del dispositivo.

online Valore booleano

Obbligatorio.

Indica se il dispositivo è online (ossia raggiungibile) o meno.

status String

Obbligatorio.

Risultato dell'operazione di query.

Valori supportati:

SUCCESS
Verifica che la query sia riuscita.
OFFLINE
Il dispositivo di destinazione è offline o non è raggiungibile.
EXCEPTIONS
A una query è associato un problema o un avviso. La query potrebbe avere esito positivo o negativo. In genere questo tipo di stato viene impostato per inviare informazioni aggiuntive su un altro dispositivo connesso.
ERROR
Impossibile eseguire la query sul dispositivo di destinazione.
errorCode String

Espansione dello stato ERRORE, se necessario, dai codici di errore preimpostati, che verranno mappati agli errori presentati agli utenti.

Esempi

Risposta per intent di 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
        }
      }
    }
  }
}