नेस्ट एपीआई जानकारी प्रदान करता है जिसका उपयोग आप घर के अनुभवों को बनाने के लिए कर सकते हैं। जानकारी अंततः उपयोगकर्ताओं के स्वामित्व में है, और उपयोगकर्ता स्पष्ट रूप से नेस्ट उत्पादों के साथ वर्क्स के साथ इस जानकारी को साझा करने का विकल्प चुन सकते हैं।
प्राधिकरण का उद्देश्य अपने ग्राहकों को अपने नेस्ट डिवाइस डेटा तक पहुंच प्रदान करने का एक सुरक्षित साधन देना है।
प्रवाह इस तरह दिखता है:
प्राधिकरण से पहले उत्पाद साइट या ऐप
आपकी उत्पाद साइट या ऐप में, आप ग्राहकों को अपने उत्पाद को उनके नेस्ट डिवाइस डेटा तक पहुंच प्रदान करने का एक तरीका प्रदान कर सकते हैं। ऐसा करने के लिए, OAuth प्रवाह आरंभ करने के लिए एक बटन या अन्य UI तत्व बनाएं।
जब आप अपने एप्लिकेशन में उपयोगकर्ता प्राधिकरण का निर्माण करते हैं, तो आप कर सकते हैं:
- किसी ऐप को अधिकृत करने के लिए बाहरी ब्राउज़र का उपयोग करें
- वेबपेज को नया बनाने के लिए एक नए पेज का उपयोग करें
आगे के डिजाइन मार्गदर्शन के लिए, नेस्ट डिजाइन नीतियों को देखें ।
iFrames
iFrames वर्तमान जानकारी, या तो एक वेब पेज में या एक मूल एप्लिकेशन में एक वेबव्यू के रूप में एम्बेडेड है। OAuth प्रवाह iFrames में एम्बेडिंग का समर्थन नहीं करता है ।
घोंसला लॉगिन
यदि उपयोगकर्ता पहले से लॉग इन नहीं है, तो हम उपयोगकर्ता को लॉग इन करने के लिए संकेत देते हैं।
कनेक्शन अधिसूचना (केवल गैर-स्वामी)
यदि उपयोगकर्ता एक परिवार के खाते का सदस्य है, और खाते में सभी संरचनाएं नहीं हैं, तो लॉगिन के बाद एक कनेक्शन अधिसूचना दिखाई देती है। यह अधिसूचना सूचीबद्ध करती है कि उपयोगकर्ता आपके वर्क्स को नेस्ट उत्पाद के साथ अधिकृत कर सकता है।
यदि उपयोगकर्ता खाता स्वामी है, तो कनेक्शन अधिसूचना दिखाई नहीं देती है, और लॉगिन के तुरंत बाद अनुमति पृष्ठ प्रदर्शित होता है।
अधिक जानकारी के लिए, पारिवारिक खाते देखें।
घोंसला अनुमति
हम आपके उत्पाद तक पहुँच प्रदान करने के लिए उपयोगकर्ता को संकेत देंगे। जब आप अपना क्लाइंट बनाते हैं तो यह पृष्ठ आपके द्वारा दर्ज की गई अनुमतियों और विवरणों को प्रदर्शित करता है।
अधिक जानकारी के लिए, अनुमतियाँ अवलोकन देखें।
प्राधिकरण के बाद उत्पाद साइट या ऐप
जब आपका ग्राहक नेस्ट उत्पाद के साथ आपके वर्क्स को अधिकृत करता है, तो हम एक प्राधिकरण कोड भेजेंगे जो आपके उत्पाद को एक्सेस टोकन के लिए विनिमय कर सकता है। नेस्ट उत्पाद के साथ आपका वर्क्स तब नेस्ट डेटा तक पहुंचने के लिए एपीआई कॉल के साथ एक्सेस टोकन भेज सकता है।
आपके ग्राहक किसी भी समय पहुंच रद्द कर सकते हैं, जो आपके वर्क्स को नेस्ट उत्पाद के साथ ग्राहक के डिवाइस डेटा के लिए आगे अनुरोध करने से रोक देगा।
किसी उपयोगकर्ता के लिए एक प्राधिकरण प्रवाह सेट करने और एक्सेस टोकन प्राप्त करने का तरीका जानने के लिए, OAuth 2.0 के साथ प्रमाणीकरण और प्राधिकरण देखें।