Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
इस पेज का अनुवाद Cloud Translation API से किया गया है.
Switch to English

प्राधिकरण संदर्भ

प्राधिकरण कोड अनुरोध

अनुरोध प्रकार के आधार पर, हम विभिन्न कोड लंबाई और TTL (टाइम-टू-लाइव) मानों को लागू करते हैं:

बहे टीटीएल कोड की लंबाई
वेब 10 मिनटों 16 अक्षर
पिन 48 घंटे 8 अक्षर

पैरामीटर

नेस्ट एपीआई में समर्थित प्राधिकरण पैरामीटर हैं:

नाम प्रकार अपेक्षित विवरण
client_id तार हाँ OAuth ग्राहक पृष्ठ पर उपलब्ध है।
redirect_uri तार नहीं वांछित पुनर्निर्देशित यूआरआई को निर्दिष्ट करने के लिए इसका उपयोग करें यदि आपके क्लाइंट के लिए कई पुनर्निर्देशित यूआरआई कॉन्फ़िगर किए गए हैं। अपने डिफ़ॉल्ट रीडायरेक्ट URI का उपयोग करने के लिए इसे स्वीकार करें।

redirect_uri पैरामीटर के भीतर किसी भी अन्य पैरामीटर को शामिल न करें , यह आपके क्लाइंट के लिए कॉन्फ़िगर किए गए रीडायरेक्ट URI से बिल्कुल मेल खाना चाहिए।
state तार हाँ CSRF के हमलों से निपटने के लिए एक गैर-अनुमानित मूल्य निर्दिष्ट करने के लिए इसका उपयोग करें। अन्यथा, STATE के डिफ़ॉल्ट मान का उपयोग करें।

पिन-आधारित प्राधिकरण त्रुटि संदेश

पिन-आधारित प्राधिकरण कोड अनुरोधों के दौरान उपयोगकर्ताओं को निम्नलिखित त्रुटि संदेश प्रदर्शित किए जा सकते हैं:

उपयोगकर्ता त्रुटि संदेश व्याख्या
ग्राहक आईडी या राज्य के पैरामीटर गुम हैं। प्राधिकरण URL या तो client_id या state पैरामीटर या दोनों गायब है। सुनिश्चित करें कि पारित प्राधिकरण URL पूर्ण और सटीक है।
ऊप्स! हमें एक त्रुटि हुई है। कृपया पुन: प्रयास करें। यह त्रुटि निम्न में से होती है:
  • नेस्ट सेवा नीचे है। नेस्ट सेवा बहाल होने तक प्रतीक्षा करें।
  • एक ग्राहक दिए गए client_id लिए मौजूद नहीं है। सुनिश्चित करें कि पारित प्राधिकरण URL सही client_id का उपयोग कर रहा है।
कंपनी नाम से कनेक्ट करना वर्तमान में अनुपलब्ध है। अधिक जानकारी के लिए नेस्ट से संपर्क करें। क्लाइंट ने उपयोगकर्ता कोटा को पार कर लिया है। अधिक उपयोगकर्ता जोड़ने के लिए अपने क्लाइंट को समीक्षा के लिए सबमिट करें।

URI- आधारित प्राधिकरण त्रुटि प्रतिक्रियाएँ पुनर्निर्देशित करें

सभी प्रतिक्रियाओं के लिए, सामग्री-प्रकार: application/json

आवश्यक पैरामीटर गुम

विवरण
HTTP स्थिति कोड 400 गलत अनुरोध
तन {
"error":"oauth2_error",
"error_description":"missing required parameters: PARAM_NAME "
}
व्याख्या एक आवश्यक पैरामीटर, PARAM_NAME , प्राधिकरण कोड अनुरोध से गायब है।

पूर्व-पंजीकृत नहीं पुनर्निर्देशित

विवरण
HTTP स्थिति कोड 400 गलत अनुरोध
तन {
"error":"input_data_error",
"error_description":"redirect_uri not pre-registered"
}
व्याख्या पहुँच अनुरोध में उपयोग किए गए redirect_uri पैरामीटर आपके क्लाइंट के लिए कॉन्फ़िगर किए गए किसी भी पुनर्निर्देशित यूआरआई से मेल नहीं खाते हैं।

टोकन अनुरोध तक पहुँचें

हम आपको इस OAuth मानक का अनुपालन करने की सलाह देते हैं, जो अनुरोध निकाय में क्लाइंट क्रेडेंशियल्स को शामिल करके बढ़ी हुई सुरक्षा प्रदान करता है। हेडर में क्लाइंट क्रेडेंशियल वाले कॉल काम करना जारी रखेंगे, लेकिन अनुशंसित नहीं हैं।

टोकन अनुरोध HTTP POST अनुरोध के रूप में है।

पैरामीटर

नाम प्रकार अपेक्षित विवरण
code तार हाँ आपके ग्राहक द्वारा नेस्ट डेटा पर आपके ऐप को एक्सेस देने के लिए सहमत होने वाला ऑथराइजेशन कोड। यह मान एक सफल प्राधिकरण कोड अनुरोध द्वारा प्रदान किया गया है।

प्राधिकरण स्थापित करना सीखें
client_id तार हाँ OAuth ग्राहक पृष्ठ पर उपलब्ध है।
client_secret तार हाँ OAuth ग्राहक पृष्ठ पर उपलब्ध है; इसे अनुप्रयोग कुंजी भी कहा जा सकता है।
grant_type तार हाँ यह स्ट्रिंग होना चाहिए: authorization_code

प्रतिक्रिया

सभी प्रतिक्रियाओं के लिए, सामग्री-प्रकार: application/json

HTTP स्थिति कोड विवरण तन
200 ठीक है प्रवेश टोकन वापस कर दिया गया है। नेस्ट सेवा के लिए कॉल में एक्सेस टोकन का उपयोग करें। टोकन समाप्त होने तक LONG सेकंड की संख्या है। {
"access_token":"STRING",
"expires_in":LONG
}

पहुंच जीवन भर टोकन

हम ताज़ा टोकन का समर्थन नहीं करते हैं , क्योंकि पहुँच टोकन प्रभावी रूप से गैर-समाप्ति वाले हैं। वेब और पिन-आधारित प्राधिकरण प्रवाह के बारे में अधिक जानकारी के लिए प्राधिकरण अवलोकन देखें।

टोकन त्रुटि प्रतिक्रियाओं तक पहुँचें

सभी प्रतिक्रियाओं के लिए, सामग्री-प्रकार: application/json

प्राधिकरण कोड समाप्त हो गया

विवरण
HTTP स्थिति कोड 400 गलत अनुरोध
तन {
"error":"oauth2_error",
"error_description":"authorization code expired"
}
व्याख्या प्राधिकरण कोड समाप्त हो गया है। पहुँच टोकन का अनुरोध करने के लिए एक नया प्राधिकरण कोड आवश्यक है।

प्राधिकरण कोड नहीं मिला

विवरण
HTTP स्थिति कोड 400 गलत अनुरोध
तन {
"error":"oauth2_error",
"error_description":"authorization code not found"
}
व्याख्या code पैरामीटर अमान्य है। जांचें कि आप सही प्राधिकरण कोड का उपयोग कर रहे हैं।

ग्राहक सक्रिय नहीं है

विवरण
HTTP स्थिति कोड 403 निषिद्ध
तन {
"error":"client_not_active",
"error_description":"client is not active"
}
व्याख्या जांचें कि आप सही मापदंडों का उपयोग कर रहे हैं। यदि पैरामीटर सही हैं, और त्रुटि केवल कुछ प्राधिकरण विधियों के लिए होती है (उदाहरण के लिए, पोस्टमैन का उपयोग करके प्राधिकरण सफल होता है, लेकिन कर्ल का उपयोग नहीं करना), तो आपके सिंटैक्स में कुछ गड़बड़ हो सकती है।

यदि आपका क्लाइंट निष्क्रिय है तो यह त्रुटि भी होती है।

ग्राहक रहस्य नहीं मिला

विवरण
HTTP स्थिति कोड 400 गलत अनुरोध
तन {
"error":"oauth2_error",
"error_description":"client secret not found"
}
व्याख्या client_secret पैरामीटर अमान्य है। जांचें कि आप सही client_secret मान का उपयोग कर रहे हैं।

आवश्यक पैरामीटर गुम

विवरण
HTTP स्थिति कोड 400 गलत अनुरोध
तन {
"error":"oauth2_error",
"error_description":"missing required parameters: PARAM_NAME "
}
व्याख्या एक आवश्यक पैरामीटर, PARAM_NAME , पहुँच अनुरोध से गायब है।

रीडायरेक्ट_यूरी की अनुमति नहीं है

विवरण
HTTP स्थिति कोड 400 गलत अनुरोध
तन {
"error":"input_error",
"error_description":"redirect_uri not allowed"
}
व्याख्या पहुंच अनुरोध में redirect_uri पैरामीटर का उपयोग किया गया था।