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