action.devices.QUERY

Bu amaç, cihazların mevcut durumlarıyla (ör. cihazın internete bağlı ve erişilebilir olup olmadığı) karşılanma durumunuzu sorgular.

QUERY yanıtınızda yalnızca durum bilgileri yer almalıdır. Cihazın özellik ve özelliklerinin güncellenmesi, SYNC yanıtı.

Daha fazla bilgi için Sorgu ve yürütme bölümünü inceleyin.

İstek biçimi

Alanlar Tür Açıklama
requestId String

Zorunludur.

İsteğin kimliği.
inputs Dizi

Zorunludur.

Amaç isteğiyle eşleşen girişlerin listesi.
[item, ...] Nesne

Amaç isteğiyle ilişkili tür ve yük.
intent

Zorunludur.

(Sabit değer: "action.devices.QUERY")

Amaç istek türü.
payload Nesne

Zorunludur.

QUERY istek yükü.
devices Dizi

Zorunludur.

Hedef cihazların listesi.
[item, ...] Nesne

Sorgulanacak cihaz hedefleri.
id String

Zorunludur.

SYNC'te sağlanan kimliğe göre cihaz kimliği.
customData Nesne

Opak customData nesnesi SYNC'te sağlanırsa buraya gönderilir.
Örnekler

QUERY intent isteği

{
  "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"
            }
          }
        ]
      }
    }
  ]
}

Yanıt biçimi

Alanlar Tür Açıklama
requestId String

Zorunludur.

İlgili isteğin kimliği.
payload Nesne

Zorunludur.

Intent yanıtı yükü.
errorCode String

Kimlik doğrulama hataları ve geliştirici sisteminin kullanılamamasıyla ilgili işlemin tamamına yönelik bir hata kodu. Bağımsız cihaz hataları için cihaz nesnesindeki errorCode'u kullanın.
debugString String

Kullanıcılara hiçbir zaman gösterilmeyecek olan ancak geliştirme sırasında günlüğe kaydedilebilen veya kullanılabilecek ayrıntılı hata.
devices Nesne

Zorunludur.

Cihazların haritası. Geliştirici cihaz kimliğini durum özelliklerinin nesnesiyle eşler.
<string> Nesne

Cihaz durumu.
online Boole

Zorunludur.

Cihazın online (yani erişilebilir) olup olmadığını gösterir.
status String

Zorunludur.

Sorgu işleminin sonucu.

Desteklenen değerler:

SUCCESS
Sorgunun başarılı olduğunu onaylayın.
OFFLINE
Hedef cihaz çevrimdışı durumda veya erişilemez durumda.
EXCEPTIONS
Bir sorguyla ilişkili sorun veya uyarı varsa Sorgu başarılı veya başarısız olabilir. Bu durum türü genellikle başka bir bağlı cihaz hakkında ek bilgi göndermek istediğinizde ayarlanır.
ERROR
Hedef cihaz sorgulanamadı.
errorCode String

Gerekirse önceden ayarlanmış hata kodlarından, kullanıcılara sunulan hatalarla eşlenecek HATA durumu genişletilir.
Örnekler

QUERY intent yanıtı

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