API keys और AI कनेक्शन के सभी 15 स्कोप: हर स्कोप किस बात की अनुमति देता है, डैशबोर्ड में उसका नाम क्या है और कोई API key क्या नहीं कर सकती।
स्कोप तय करते हैं कि कोई API key क्या कर सकती है। यही 15 स्कोप उन AI असिस्टेंट पर भी लागू होते हैं जिन्हें आप MCP से जोड़ते हैं। हमेशा सिर्फ़ वही स्कोप चुनें जिनकी किसी ऐप्लिकेशन को सच में ज़रूरत है।
बुनियादी नियम
- हर एंडपॉइंट को ठीक एक स्कोप चाहिए
- API keys के लिए write:X में read:X अपने आप शामिल है – डैशबोर्ड बताता है “write:X में अपने आप read:X भी शामिल होता है”
- स्कोप न होने पर API 403 insufficient_scope के साथ जवाब देता है और ज़रूरी स्कोप का नाम details.required_scope में बताता है
- जो एंडपॉइंट API keys के लिए बिल्कुल चालू नहीं हैं, वे भी 403 insufficient_scope के साथ जवाब देते हैं
- सदस्य, बिलिंग या डोमेन मैनेज करने जैसे मालिक और एडमिन के फ़ंक्शन किसी भी स्कोप से नहीं पहुँचे जा सकते
सभी स्कोप
“नई API key बनाएँ” डायलॉग में आप हर हिस्से के लिए “पढ़ना” या “लिखना” चुनते हैं; key की सूची पहले कॉलम वाले स्कोप नाम दिखाती है। “पढ़ना · पेज” वाला रूप AI ऐप के सहमति पेज पर और “कनेक्ट किए गए ऐप” के तहत दिखता है।
| स्कोप | AI ऐप के लिए | किसकी अनुमति देता है |
|---|---|---|
| read:pages | पढ़ना · पेज | पेजों की सूची बनाना और पढ़ना, ड्राफ़्ट पढ़ना और जाँचना, ब्लॉक की सूची, SEO पढ़ना, वर्ज़न की सूची, ब्लॉक प्रकार लाना |
| write:pages | लिखना · पेज | पेज बनाना और बदलना (हैंडल समेत), ड्राफ़्ट बदलना, ब्लॉक बनाना, बदलना, हटाना और क्रम बदलना, SEO बदलना, दृश्यता, पब्लिश करना, वर्ज़न बहाल करना, निजी पेजों के आमंत्रण लिंक |
| read:links | पढ़ना · लिंक | किसी पेज के लिंक की सूची बनाना और पढ़ना |
| write:links | लिखना · लिंक | लिंक बनाना, बदलना, हटाना और क्रम बदलना |
| read:assets | पढ़ना · फ़ाइलें | फ़ाइलों की सूची |
| write:assets | लिखना · फ़ाइलें | फ़ाइलें अपलोड करना और हटाना, किसी पेज के लिए अपलोड |
| read:forms | पढ़ना · फ़ॉर्म | फ़ॉर्म पढ़ना, सारांश, सबमिशन की सूची और उन्हें CSV में एक्सपोर्ट करना (एक्सपोर्ट Creator Pro से) |
| write:forms | लिखना · फ़ॉर्म | फ़ॉर्म बनाना, बदलना और हटाना |
| read:stats | पढ़ना · आँकड़े | पेज और वर्कस्पेस के आँकड़े (सारांश, टाइम सीरीज़, तुलना, लिंक, विजेट, कन्वर्ज़न, टॉप पेज), पुश इतिहास और पुश इस्तेमाल |
| read:workspaces | पढ़ना · वर्कस्पेस | प्लान फ़ीचर, इस्तेमाल, सदस्य सूची और वर्कस्पेस सेटिंग पढ़ना, डोमेन की सूची, टेम्पलेट की सूची और पढ़ना, callback secrets की सूची और पढ़ना (सादे टेक्स्ट वाले secret के बिना) |
| write:workspaces | लिखना · वर्कस्पेस | अभी read:workspaces से आगे कोई एंडपॉइंट नहीं |
| read:donations | पढ़ना · समर्थकों के भुगतान | वर्कस्पेस के समर्थकों के भुगतान का कुल (“सपोर्ट करें” ब्लॉक से हुए भुगतान) |
| read:short_links | पढ़ना · शॉर्ट लिंक | शॉर्ट लिंक की सूची और पढ़ना |
| write:short_links | लिखना · शॉर्ट लिंक | शॉर्ट लिंक बनाना, बदलना और हटाना |
| write:templates | लिखना · वर्कस्पेस टेम्पलेट | अपने वर्कस्पेस टेम्पलेट बनाना, बदलना और हटाना (इन्हें read:workspaces से पढ़ा जाता है), देखें अपने टेम्पलेट |
कौन-सा एंडपॉइंट ठीक किस स्कोप का है, यह हिस्सों के हिसाब से एंडपॉइंट में दिखाया गया है।
कोई API key क्या नहीं कर सकती
- पेज हटाना
- ड्राफ़्ट के पूर्वावलोकन लिंक बनाना
- डिवाइस, देश, रेफ़रर और UTM के हिसाब से आँकड़ों के ब्रेकडाउन
- पुश नोटिफ़िकेशन भेजना और पुश नियम मैनेज करना
- इंटीग्रेशन जोड़ना या हटाना
- Webhooks मैनेज करना
- डोमेन जोड़ना, सत्यापित करना, सक्रिय करना, निष्क्रिय करना या हटाना
- सदस्य, आमंत्रण और भूमिकाएँ मैनेज करना, मालिकाना हक़ ट्रांसफ़र करना
- वर्कस्पेस सेटिंग, बिलिंग बदलना
- callback secrets बनाना, बदलना, rotate करना या हटाना
- समर्थकों के भुगतान की सूची, डेटा अनुरोध और फ़ॉर्म सबमिशन को गुमनाम बनाना
- अपनी प्रोफ़ाइल, आपके फ़ॉलो किए पेज और ख़ुद API keys मैनेज करना
ये काम आप डैशबोर्ड में करते हैं।
AI असिस्टेंट के लिए स्कोप
MCP कनेक्शन के लिए आप सहमति पेज पर यही स्कोप चुनते हैं। दो अंतर हैं: पहला, वहाँ लिखने की अनुमति में पढ़ने की अनुमति शामिल नहीं होती – इसलिए दोनों दें। दूसरा, आपकी भूमिका चुनाव सीमित करती है: दर्शकों को सिर्फ़ पढ़ने की अनुमतियाँ मिलती हैं (फ़ॉर्म और शॉर्ट लिंक के बिना), एडिटर को “लिखना · वर्कस्पेस”, शॉर्ट लिंक और वर्कस्पेस टेम्पलेट को छोड़कर सब। ज़्यादा जानकारी अनुमतियाँ, सुरक्षा और सीमाएँ में।
सुझाए गए मेल
| इस्तेमाल | स्कोप |
|---|---|
| रिपोर्टिंग और डैशबोर्ड | read:stats, read:pages |
| किसी CMS या शॉप से लिंक सिंक करना | write:links, read:pages |
| पेज अपने आप सँभालना और पब्लिश करना | write:pages, write:links |
| CRM से कैंपेन लिंक | write:short_links |
| फ़ॉर्म से लीड CRM तक पहुँचाना | read:forms |
| CI पाइपलाइन से टेम्पलेट रोल आउट करना | write:templates, read:workspaces |
यह भी आपके काम आ सकता है
कुछ नहीं मिला?
हमें बताएँ कि आपको क्या चाहिए, और हमारी सपोर्ट टीम ख़ुद आपकी मदद करेगी।