कीज़ और वेबहुक
इस वर्कस्पेस द्वारा जारी किए गए क्रेडेंशियल और एंडपॉइंट।
कीज़ और वेबहुक टूल
| टूल | यह क्या करता है |
|---|---|
| listApiKeys | इस वर्कस्पेस द्वारा जारी की गई हर API key, वह क्या कर सकती है और किस पते से भेज सकती है, ऐसे छिपे हुए रूप में जो दो keys को अलग पहचानने भर के लिए काफ़ी है, उससे ज़्यादा कुछ नहीं। |
| rotateApiKey | किसी key को नया secret दें, उसकी id, नाम, स्कोप, रोल और send scope बरकरार रखते हुए। कोई ओवरलैप अवधि नहीं होती, और नया secret एक ही बार दिखाया जाता है। |
| setApiKeyEnabled | किसी key को बंद करें, या फिर से चालू करें। यही वह क्रिया है जिसे पलटा जा सकता है: key अपना secret, अपने स्कोप, अपना रोल और अपना send scope बनाए रखती है। |
| revokeApiKey | किसी key को हमेशा के लिए रद्द करें। रद्द की गई key को न कभी दोबारा चालू किया जा सकता है, न rotate किया जा सकता है और न बदला जा सकता है। |
| setApiKeySendScope | बताएँ कि कोई key किन पतों से भेज सकती है, दो स्वतंत्र सूचियों के रूप में। आप जो भेजते हैं वह key के पास पहले से जो था उसकी जगह ले लेता है। |
| listWebhooks | इस वर्कस्पेस का हर वेबहुक एंडपॉइंट, वह कहाँ पोस्ट करता है, चालू है या नहीं, और उसने कौन से इवेंट माँगे हैं। साइनिंग secret कभी नहीं दिखाए जाते। |
| listWebhookEvents | हर वह इवेंट जिसे कोई एंडपॉइंट सब्सक्राइब कर सकता है, परिवार के हिसाब से समूहबद्ध, और हर एक के साथ एक पंक्ति जो बताती है कि वह कब चलता है। |
secret एक ही बार दिखाया जाता है, जब key बनाई या rotate की जाती है, और उसके बाद उसे कुछ भी वापस नहीं ला सकता। यहाँ rotateApiKey ही एकमात्र टूल है जो कोई secret लौटाता है, इसलिए जिसके पास पुराना secret है उसे अगली बार चलने से पहले नया थमाना पड़ता है।
revokeApiKey से पहले setApiKeyEnabled का सहारा लें। किसी key को बंद करना पलटा जा सकता है और बता देता है कि कोई चीज़ अब भी उस पर निर्भर है या नहीं; रद्द करना स्थायी है और उसके आगे का एकमात्र रास्ता नई key और नया secret है।
यहाँ न कोई createApiKey है और न createWebhook, उसी वजह से जिससे कोई createRole नहीं है: चैट विंडो के भीतर से कोई क्रेडेंशियल जारी करना एक चुपचाप हुआ, बड़ा बदलाव है जिसे बाद में कोई नहीं देखता। दोनों Settings में हैं, जहाँ जो व्यक्ति यह कर रहा है वह देख सकता है कि वह क्या सौंप रहा है।