API کلیدوں اور AI کنکشنز کی تمام 15 اسکوپس: ہر اسکوپ کیا اجازت دیتی ہے، ڈیش بورڈ میں اس کا نام کیا ہے اور کوئی API کلید کیا نہیں کر سکتی۔
اسکوپس طے کرتی ہیں کہ کوئی API کلید کیا کر سکتی ہے۔ یہی 15 اسکوپس ان AI اسسٹنٹس پر بھی لاگو ہوتی ہیں جنہیں آپ MCP کے ذریعے جوڑتے ہیں۔ ہمیشہ صرف وہی اسکوپس چنیں جن کی کسی ایپلیکیشن کو واقعی ضرورت ہے۔
بنیادی اصول
- ہر اینڈپوائنٹ کو بالکل ایک اسکوپ درکار ہوتی ہے
- API کلیدوں کے لیے write:X میں read:X خود بخود شامل ہوتا ہے – ڈیش بورڈ میں یہ نوٹ ہوتا ہے: “write:X میں خود بخود read:X شامل ہے”
- اگر اسکوپ موجود نہ ہو تو API 403 insufficient_scope سے جواب دیتا ہے اور details.required_scope میں مطلوبہ اسکوپ بتاتا ہے
- جو اینڈپوائنٹس API کلیدوں کے لیے بالکل فعال نہیں وہ بھی 403 insufficient_scope سے جواب دیتے ہیں
- مالک اور ایڈمن کے فنکشنز، جیسے ممبرز، بلنگ یا ڈومینز کا انتظام، کسی بھی اسکوپ سے قابل رسائی نہیں
تمام اسکوپس
“نئی API کلید بنائیں” ڈائیلاگ میں آپ ہر حصے کے لیے “پڑھنا” یا “لکھنا” چنتے ہیں؛ کلیدوں کی فہرست پہلے کالم والے اسکوپ نام دکھاتی ہے۔ “پڑھنا · صفحات” والی شکل 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 | پڑھنا · ورک اسپیسز | پلان کے فیچرز، استعمال، ممبرز کی فہرست اور ورک اسپیس سیٹنگز پڑھنا، ڈومینز کی فہرست، ٹیمپلیٹس کی فہرست اور انہیں پڑھنا، کال بیک سیکرٹس کی فہرست اور انہیں پڑھنا (سادہ متن والے سیکرٹ کے بغیر) |
| write:workspaces | لکھنا · ورک اسپیسز | فی الحال read:workspaces سے آگے کوئی اینڈپوائنٹ نہیں |
| read:donations | پڑھنا · حامیوں کی ادائیگیاں | ورک اسپیس کی حامیوں کی ادائیگیوں کا مجموعہ (“سپورٹ کریں” بلاک کے ذریعے ادائیگیاں) |
| read:short_links | پڑھنا · مختصر لنکس | مختصر لنکس کی فہرست اور انہیں پڑھنا |
| write:short_links | لکھنا · مختصر لنکس | مختصر لنکس بنانا، ترمیم اور حذف کرنا |
| write:templates | لکھنا · ورک اسپیس ٹیمپلیٹس | اپنی ورک اسپیس ٹیمپلیٹس بنانا، ترمیم اور حذف کرنا (انہیں read:workspaces سے پڑھا جاتا ہے)، دیکھیں کسٹم ٹیمپلیٹس |
کون سا اینڈپوائنٹ کس اسکوپ سے تعلق رکھتا ہے، یہ حصوں کے لحاظ سے اینڈپوائنٹس میں دکھایا گیا ہے۔
جو کوئی API کلید نہیں کر سکتی
- صفحات حذف کرنا
- ڈرافٹ کے لیے پیش منظر لنکس بنانا
- ڈیوائس، ملک، ریفرر اور UTM کے لحاظ سے اعداد و شمار کی تفصیل
- پش نوٹیفکیشنز بھیجنا اور پش قواعد کا انتظام
- انٹیگریشنز جوڑنا یا منقطع کرنا
- ویب ہُکس کا انتظام
- ڈومینز شامل کرنا، تصدیق، فعال، غیر فعال یا حذف کرنا
- ممبرز، دعوت ناموں اور رولز کا انتظام، ملکیت منتقل کرنا
- ورک اسپیس سیٹنگز اور بلنگ تبدیل کرنا
- کال بیک سیکرٹس بنانا، ترمیم، تبدیل یا حذف کرنا
- حامیوں کی ادائیگیوں کی فہرست، ڈیٹا تک رسائی کی درخواستیں اور فارم جوابات کو گمنام کرنا
- اپنی پروفائل، آپ کے فالو کیے ہوئے صفحات اور خود API کلیدوں کا انتظام
یہ کام آپ ڈیش بورڈ میں کرتے ہیں۔
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 |
یہ بھی آپ کے کام آ سکتا ہے
کچھ نہیں ملا؟
ہمیں بتائیں کہ آپ کو کیا چاہیے، ہماری سپورٹ ٹیم ذاتی طور پر آپ کی مدد کرے گی۔