action.devices.QUERY

এই অভিপ্রায় ডিভাইসের বর্তমান অবস্থার জন্য আপনার পূর্ণতা সম্পর্কে প্রশ্ন করে, যার মধ্যে ডিভাইসটি অনলাইন এবং পৌঁছানো যায় কিনা।

আপনার QUERY প্রতিক্রিয়া শুধুমাত্র রাষ্ট্রীয় তথ্য প্রদান করবে। ডিভাইসের বৈশিষ্ট্য এবং বৈশিষ্ট্য আপডেট করা SYNC প্রতিক্রিয়া দ্বারা পরিচালিত হয়।

আরো বিস্তারিত জানার জন্য, ক্যোয়ারী এবং এক্সিকিউট দেখুন।

বিন্যাস অনুরোধ

ক্ষেত্র	টাইপ	বর্ণনা
requestId	স্ট্রিং	প্রয়োজন। অনুরোধের আইডি।
inputs	অ্যারে	প্রয়োজন। অভিপ্রায় অনুরোধের সাথে মিলে যাওয়া ইনপুটগুলির তালিকা৷
[ item, ... ]	অবজেক্ট	উদ্দেশ্য অনুরোধের সাথে যুক্ত টাইপ এবং পেলোড।
intent		প্রয়োজন। (ধ্রুবক মান: "action.devices.QUERY" ) উদ্দেশ্য অনুরোধের ধরন।
payload	অবজেক্ট	প্রয়োজন। QUERY অনুরোধ পেলোড৷
devices	অ্যারে	প্রয়োজন। লক্ষ্য ডিভাইসের তালিকা.
[ item, ... ]	অবজেক্ট	ক্যোয়ারী করার জন্য ডিভাইস টার্গেট।
id	স্ট্রিং	প্রয়োজন। SYNC এ প্রদত্ত আইডি অনুযায়ী ডিভাইস আইডি।
customData	অবজেক্ট	অস্বচ্ছ কাস্টমডেটা অবজেক্টটি SYNC-তে প্রদান করা হলে, এটি এখানে পাঠানো হয়।

উদাহরণ

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	স্ট্রিং	প্রয়োজন। সংশ্লিষ্ট অনুরোধের আইডি।
payload	অবজেক্ট	প্রয়োজন। অভিপ্রায় প্রতিক্রিয়া পেলোড.
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
        }
      }
    }
  }
}