كل النطاقات الـ 15 لمفاتيح API واتصالات الذكاء الاصطناعي: ما يسمح به كل نطاق، واسمه في لوحة التحكم، وما لا يستطيعه أي مفتاح API.
تحدد النطاقات ما يُسمح لمفتاح API بفعله. والنطاقات الـ 15 نفسها تسري أيضًا على مساعدي الذكاء الاصطناعي الذين تربطهم عبر MCP. اختر دائمًا النطاقات التي يحتاج إليها التطبيق فعلًا فقط.
القواعد الأساسية
- كل نقطة نهاية تتطلب نطاقًا واحدًا بالضبط
- في مفاتيح API يتضمن write:X تلقائيًا read:X؛ وتنبّه لوحة التحكم إلى ذلك بعبارة «write:X يتضمن read:X تلقائيًا»
- إذا كان النطاق مفقودًا، تستجيب الـ API بالخطأ 403 insufficient_scope وتذكر النطاق المطلوب في details.required_scope
- نقاط النهاية غير المفعّلة لمفاتيح API إطلاقًا تستجيب أيضًا بـ 403 insufficient_scope
- وظائف المالك والمسؤول، مثل الأعضاء أو الفوترة أو إدارة النطاقات المخصصة، لا يمكن الوصول إليها بأي نطاق
كل النطاقات
في نافذة «إنشاء مفتاح API جديد» تختار «قراءة» أو «كتابة» لكل مجال؛ وتعرض قائمة المفاتيح أسماء النطاقات من العمود الأول. أما صيغة «قراءة · الصفحات» فتظهر في صفحة الموافقة لتطبيقات الذكاء الاصطناعي وتحت «التطبيقات المتصلة».
| النطاق | لتطبيقات الذكاء الاصطناعي | يسمح بـ |
|---|---|---|
| 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 وقراءتها (دون السر بنص صريح) |
| write:workspaces | كتابة · مساحات العمل | لا توجد حاليًا نقاط نهاية تتجاوز read:workspaces |
| read:donations | قراءة · مدفوعات الداعمين | مجاميع مدفوعات الداعمين في مساحة العمل (المدفوعات عبر كتلة «ادعم») |
| read:short_links | قراءة · الروابط المختصرة | سرد الروابط المختصرة وقراءتها |
| write:short_links | كتابة · الروابط المختصرة | إنشاء الروابط المختصرة وتعديلها وحذفها |
| write:templates | كتابة · قوالب مساحة العمل | إنشاء قوالب مساحة العمل الخاصة بك وتعديلها وحذفها (تُقرأ بالنطاق read:workspaces)، انظر قوالب مخصصة للمطوّرين والوكالات |
أي نقاط نهاية تتبع أي نطاق بالضبط تجده في نقاط نهاية الـ API حسب المجال.
ما لا يستطيعه أي مفتاح API
- حذف الصفحات
- إنشاء روابط معاينة للمسودة
- تفصيل الإحصائيات حسب الجهاز والبلد والمُحيل وUTM
- إرسال الإشعارات الفورية وإدارة قواعد الإشعارات الفورية
- ربط التكاملات أو فصلها
- إدارة الـ Webhooks
- إضافة النطاقات المخصصة أو التحقق منها أو تفعيلها أو إلغاء تفعيلها أو حذفها
- إدارة الأعضاء والدعوات والأدوار، ونقل الملكية
- تغيير إعدادات مساحة العمل، والفوترة
- إنشاء أسرار Callback أو تعديلها أو تدويرها أو حذفها
- قائمة مدفوعات الداعمين، وطلبات الاطلاع على البيانات، وإخفاء هوية إرسالات النماذج
- إدارة ملفك الشخصي والصفحات التي تتابعها ومفاتيح API نفسها
هذه الأمور تقوم بها في لوحة التحكم.
النطاقات لمساعدي الذكاء الاصطناعي
لاتصال MCP تختار النطاقات نفسها في صفحة الموافقة. وهناك فرقان: أولًا، إذن الكتابة هناك لا يتضمن إذن القراءة، فامنح الاثنين. ثانيًا، دورك يحدّ الاختيار: المشاهدون يحصلون على أذونات القراءة فقط (دون النماذج والروابط المختصرة)، والمحرّرون على كل شيء عدا «كتابة · مساحات العمل» والروابط المختصرة وقوالب مساحة العمل. المزيد في مساعدو الذكاء الاصطناعي: الصلاحيات والأمان والحدود.
تركيبات مقترحة
| حالة الاستخدام | النطاقات |
|---|---|
| التقارير ولوحات المعلومات | read:stats، read:pages |
| مزامنة الروابط من نظام إدارة محتوى أو متجر | write:links، read:pages |
| صيانة الصفحات ونشرها تلقائيًا | write:pages، write:links |
| روابط الحملات من نظام CRM | write:short_links |
| تمرير العملاء المحتملين من النماذج إلى CRM | read:forms |
| طرح القوالب من خط CI | write:templates، read:workspaces |
قد يفيدك أيضًا
لم تجد ما تبحث عنه؟
أخبرنا بما تحتاج إليه، وسيساعدك فريق الدعم لدينا شخصيًا.