API কী আর AI সংযোগের ১৫টি স্কোপ: প্রতিটি স্কোপ কী করতে দেয়, ড্যাশবোর্ডে এর নাম কী এবং কোনো API কী-ই যা করতে পারে না।
স্কোপ ঠিক করে একটি API কী কী করতে পারবে। MCP দিয়ে যুক্ত করা AI অ্যাসিস্ট্যান্টের ক্ষেত্রেও একই ১৫টি স্কোপ প্রযোজ্য। সবসময় শুধু সেই স্কোপগুলোই বেছে নিন যা একটি অ্যাপ্লিকেশনের সত্যিই দরকার।
মৌলিক নিয়ম
- প্রতিটি এন্ডপয়েন্টের জন্য ঠিক একটি স্কোপ দরকার
- 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 এন্ডপয়েন্ট-এ।
কোনো API কী-ই যা করতে পারে না
- পেজ মোছা
- খসড়ার প্রিভিউ লিংক তৈরি করা
- ডিভাইস, দেশ, রেফারার আর UTM অনুযায়ী পরিসংখ্যানের ভাগ
- পুশ নোটিফিকেশন পাঠানো আর পুশ রুল পরিচালনা করা
- ইন্টিগ্রেশন সংযুক্ত বা বিচ্ছিন্ন করা
- ওয়েবহুক পরিচালনা করা
- ডোমেইন যোগ, যাচাই, সক্রিয়, নিষ্ক্রিয় বা মোছা
- সদস্য, আমন্ত্রণ আর রোল পরিচালনা করা, মালিকানা হস্তান্তর
- ওয়ার্কস্পেস সেটিংস আর বিলিং পরিবর্তন করা
- কলব্যাক সিক্রেট তৈরি, সম্পাদনা, রোটেট বা মোছা
- সমর্থকদের পেমেন্টের তালিকা, ডেটা অ্যাক্সেসের অনুরোধ আর ফর্ম সাবমিশন বেনামি করা
- আপনার প্রোফাইল, যে পেজগুলো আপনি ফলো করেন আর খোদ API কী পরিচালনা করা
এগুলো আপনি ড্যাশবোর্ডে করেন।
AI অ্যাসিস্ট্যান্টের জন্য স্কোপ
MCP সংযোগের জন্য আপনি সম্মতি পেজে একই স্কোপগুলো বেছে নেন। পার্থক্য দুটি: প্রথমত, সেখানে লেখার অনুমতি পড়ার অনুমতি অন্তর্ভুক্ত করে না – তাই দুটোই দিন। দ্বিতীয়ত, আপনার রোল বাছাই সীমিত করে: ভিউয়াররা শুধু পড়ার অনুমতি পান (ফর্ম আর শর্ট লিংক ছাড়া), এডিটররা “লেখা · ওয়ার্কস্পেস”, শর্ট লিংক আর ওয়ার্কস্পেস টেমপ্লেট ছাড়া সবকিছু পান। আরও আছে AI অ্যাসিস্ট্যান্ট: অনুমতি, নিরাপত্তা ও সীমা-এ।
প্রস্তাবিত কম্বিনেশন
| ব্যবহারের ক্ষেত্র | স্কোপ |
|---|---|
| রিপোর্টিং আর ড্যাশবোর্ড | 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 |
এগুলোও কাজে আসতে পারে
কিছু খুঁজে পাননি?
আপনার কী দরকার তা আমাদের জানান, আমাদের সাপোর্ট টিম ব্যক্তিগতভাবে আপনাকে সাহায্য করবে।