Nest API रेफ़रंस

Nest API इस तरह के घर या घर को बनाने का काम करता है. इनमें Nest Learning Learning Thermostat, Nest Protect, और Nest Cam को डिवाइस के तौर पर इस्तेमाल किया जाता है. इस स्ट्रक्चर में घर की पूरी जानकारी भी शामिल है, जैसे कि अवे या ईटीए स्टेट या बिजली की ज़्यादा खपत वाले समय में.

स्ट्रक्चर के हर डेटा एलिमेंट को, शेयर किए गए JSON दस्तावेज़ में, संसाधन यूआरएल (जिसे "&kot;डेटा लोकेशन") कहा जाता है. हर डेटा की जगह में स्ट्रिंग, नंबर, बूलियन, पैरंट/चाइल्ड ऑब्जेक्ट या श्रेणियां स्टोर हो सकती हैं.

इंटरैक्टिव एपीआई रेफ़रंस की मदद से, डेटा मॉडल के बारे में जानें.

एपीआई से, आप डेटा मॉडल में कई लेवल पर जगहों के डेटा को सिंक कर सकते हैं. उदाहरण के लिए:

  • एक पूरी संरचना, जिसमें सभी डिवाइस शामिल हैं
  • स्ट्रक्चर में मौजूद एक डिवाइस
  • डेटा वैल्यू का ग्रुप (मौजूदा और आस-पास का तापमान)
  • सिंगल डेटा वैल्यू (बैटरी की स्थिति)

आपके प्रॉडक्ट को इस तरह के इवेंट के लिए सोच-समझकर जवाब देना चाहिए:

हालांकि, ध्यान रखें कि हर डिवाइस के हिसाब से ऑब्जेक्ट, असल ज़िंदगी से जुड़ी पाबंदियों के तहत काम कर रहा है. उदाहरण के लिए, आपातकालीन गर्म मोड चालू होने पर थर्मोस्टैट को एयर कंडीशनर नहीं चलाना चाहिए. हमारा एपीआई इस तरह से डिज़ाइन किया गया है कि वह हमारे डिवाइस और उपयोगकर्ता के घर, दोनों की सुरक्षा को ध्यान में रखे. साथ ही, अगर वे हैरान करने वाले या खतरनाक हों, तो वे कुछ कार्रवाइयों को भी नहीं करेंगे.

अनुमतियां और शेयर किया गया डिवाइस डेटा

डेटा से जुड़ी किसी जगह की जानकारी को पढ़ने या उसमें लिखने की सुविधा को अनुमतियां मैनेज करती हैं. अनुमतियों के ग्रुप, डिवाइसों और स्ट्रक्चर में चुने गए डेटा वैल्यू को पढ़ने, लिखने या पढ़ने का ऐक्सेस देते हैं.

ज़्यादा जानकारी के लिए, अनुमतियों की खास जानकारी देखें.

डेटा और निजता

होम प्रॉडक्ट से जुड़ा डेटा काफ़ी निजी हो सकता है. होम सेंसर डेटा इस बारे में जानकारी देता है कि लोग अपनी निजी जगह पर कैसे रहते हैं. उस डेटा की सुरक्षा और इसे मैनेज करना बहुत ज़रूरी है. साथ ही, Nest पर इस बात का खास ध्यान दिया जाता है. हम उपयोगकर्ताओं को साफ़ तौर पर यह बताते हैं कि हमारे पास किस तरह का डेटा है, यह कैसे इस्तेमाल किया जाता है, और इसे कैसे कंट्रोल किया जा सकता है.

निजता पर हमारे व्यू के बारे में ज़्यादा जानें.

मेटाडेटा

मेटाडेटा वह अतिरिक्त जानकारी होती है जो रूट-लेवल एंडपॉइंट पर कॉल करते समय दी जाती है:

https://developer-api.nest.com/

access_token

उपयोगकर्ता की अनुमति के बाद, Nest सेवा को एपीआई कॉल करने के लिए, आपका प्रॉडक्ट ऐक्सेस टोकन का इस्तेमाल करता है. यह ऐक्सेस टोकन इस बात का सबूत है कि उपयोगकर्ता ने आपके प्रॉडक्ट को कॉल करने की अनुमति दी है.

ब्यौरा
लौटाए गए सामानstring
उदाहरण: &quat;c.FmDPkzyzaQe...&कोटेशन;

क्लाइंट_वर्शन

क्लाइंट वर्शन, क्लाइंट का आखिरी उपयोगकर्ता का अनुमति वाला वर्शन होता है और वह access_token से जुड़ा होता है.

जब आप किसी क्लाइंट की अनुमतियां अपडेट करते हैं, तो क्लाइंट वर्शन में बढ़ोतरी होती है और उपयोगकर्ता को सूचना मिलती है कि अपडेट उपलब्ध है. आपके क्लाइंट को इस अपडेट को स्वीकार करना होगा, ताकि वे आपके अपडेट किए गए प्रॉडक्ट का इस्तेमाल कर सकें.

ब्यौरा
लौटाए गए सामानnumber
उदाहरण: 1, 17, 42

user_id

यूज़र आईडी की मदद से, एपीआई कॉल में उपयोगकर्ताओं की पहचान की जा सकती है. यह आइडेंटिफ़ायर, Nest के साथ काम करने वाले हर प्रॉडक्ट और उपयोगकर्ता के कॉम्बिनेशन के लिए अलग-अलग होता है.

उदाहरण के लिए, अगर उपयोगकर्ता 1 के पास Works with Nest प्रॉडक्ट A और Nest प्रॉडक्ट B वाले Works हैं, तो प्रॉडक्ट A में उपयोगकर्ता 1 के लिए एक user_id वैल्यू और उपयोगकर्ता B के लिए अलग वैल्यू user_id है.

ब्यौरा
लौटाए गए सामानstring
उदाहरण: z.1.1.7DHps...