रीडायरेक्ट URI आपके एप्लिकेशन का कॉलबैक URL है जिस पर उपयोगकर्ता को सफल प्राधिकरण के बाद रीडायरेक्ट किया जाएगा। सर्वर रीडायरेक्ट URL में क्वेरी स्ट्रिंग के रूप में एक code पैरामीटर लौटाता है। इस code का उपयोग एक्सेस और रिफ्रेश टोकन प्राप्त करने के लिए किया जाता है।
उदाहरण
https://www.zylker.com.
क्रेडेंशियल Client ID और Client Secret स्थायी हैं। यदि ये समाप्त हो जाएं या उपयोगकर्ता नोट बनाने में विफल रहें, तो वे इसे अपने एप्लिकेशन को रजिस्टर करें का उपयोग करके OAuth 2.0 प्राधिकरण प्रक्रिया में फिर से बना सकते हैं।
टोकन (एक्सेस और रिफ्रेश) जेनरेट करने के लिए URL को ब्राउज़र में सीधे नहीं डाला जाना चाहिए क्योंकि यह GET अनुरोध नहीं बल्कि POST है। इसे कोड के माध्यम से या Postman जैसे टूल का उपयोग करके प्रबंधित किया जाना चाहिए।
प्रत्येक API का स्कोप उनके संबंधित Modules में दिया गया है। API को एक्सेस करने के लिए स्कोप अनिवार्य है।
सिंटैक्स
ZohoProjects.<module>.<operation>
उदाहरण
ZohoProjects.portals.READ.
एक उपयोगकर्ता के पास अधिकतम बीस रिफ्रेश टोकन हो सकते हैं। इस सीमा से अधिक होने पर एक त्रुटि (Access Denied) प्रदर्शित होती है। नया टोकन जेनरेट करने से पहले पुराने टोकन को रद्द करना सर्वोत्तम अभ्यास है।
प्रत्येक रिफ्रेश टोकन के पास अधिकतम तीस सक्रिय एक्सेस टोकन हो सकते हैं। जब आप इस अधिकतम संख्या से अधिक हो जाते हैं, तो पहला एक्सेस टोकन हटा दिया जाएगा चाहे वह सक्रिय हो या नहीं।
एक उपयोगकर्ता Client ID के लिए प्रति मिनट चार प्राधिकरण code जेनरेट कर सकता है। इसके बाद, अगले दस मिनट के लिए एक्सेस अस्थायी रूप से अवरुद्ध हो जाता है।
यह तब होता है जब एक्सेस टोकन समाप्त हो जाता है। यदि access_type offline है, तो एक्सेस और रिफ्रेश दोनों टोकन जेनरेट किए जाते हैं, जबकि ऑनलाइन एक्सेस प्रकार के लिए केवल एक्सेस टोकन जेनरेट किया जाता है। दोनों मामलों में, एक्सेस टोकन केवल एक घंटे के लिए वैध है।
यह तब होता है जब प्राधिकरण code समाप्त हो जाता है। प्राधिकरण code केवल 2 मिनट के लिए वैध है। हालांकि, आप उपयोगकर्ता प्राधिकरण अनुरोध का उपयोग करके OAuth 2.0 प्राधिकरण प्रक्रिया में यदि आवश्यक हो तो code को फिर से बना सकते हैं।