تخطي إلى المحتوى
مركز مساعدة Clevera

إدارة الرموز المميزة لواجهة برمجة التطبيقات (API) وإعادة إنشائها وإلغاؤها

اعثر على رموز API الخاصة بك، وأعد إنشاء رمز سري (مرة واحدة، مع خيار تداخل لمدة 24 ساعة)، وقم بإلغاء رمز مميز، وافهم كيفية انتهاء الصلاحية وقوائم السماح لعناوين IP، واعرف سبب توقف الرمز المميز عن العمل.

تم التحديث وقت القراءة 8 دقائق

تعرض علامة التبويب الرموز قائمة برموز API الخاصة بك مع معلومات الوصول والحدود وآخر استخدام. ومن هناك يمكنك إعادة إنشاء الرمز السري للرمز المميز، وإلغاء رمز مميز، ومعرفة سبب توقف الرمز المميز عن العمل.

أين تجد رموزك المميزة

افتح قائمة مساحة العمل واختر AI agents & API. علامة التبويب الرموز هي علامة التبويب الأولى؛ وتعرض كل علامة تبويب عدد الرموز الموجودة فيها.

علامة التبويب "الرموز" الخاصة بـ AI agents & API، والتي تسرد ثلاثة رموز API مع المالك والأذونات والمواقع وتاريخ انتهاء الصلاحية.
يرى المالكون والمسؤولون كل رمز مميز في مساحة العمل.

من يرى أي الرموز:

دورك ما تراه ما يمكنك فعله
المالك أو المسؤول "كل رمز مميز في مساحة العمل هذه. يرى الأعضاء رموزهم الخاصة." التصفية حسب الشخص باستخدام قائمة المالك (الجميع تعرض الكل). إلغاء أي رمز مميز. إعادة إنشاء رموزك الخاصة فقط.
المحرر أو منشئ المحتوى "رموزك الخاصة. الوكلاء الذين يستخدمونها يتصرفون بصفتك." إلغاء وإعادة إنشاء رموزك الخاصة.

يعرض كل صف الاسم (مع الأحرف الأخيرة من الرمز السري، مثل clv_agent_…k7Qe)، والمالك، والوصول (أذوناته)، والمواقع التي يغطيها، وتم الإنشاء، وآخر استخدام، وتنتهي صلاحيته. يحسب التذييل عدد الرموز المميزة النشطة في مساحة العمل مقابل حدها الأقصى. شارات على الصف:

الشارة المعنى
ينفق الرصيد الرمز المميز لديه credits:spend. أشر إليه لرؤية حدوده: لكل مهمة، يومياً، شهرياً ("بدون حد" عندما يكون فارغاً) و"تمت الموافقة تلقائياً بأقل من n من الرصيد" أو "يوافق شخص ما على كل عملية بدء مدفوعة".
مقيّد بعنوان IP الرمز المميز لديه قائمة سماح لعناوين IP ولا يعمل إلا من تلك العناوين.
يتجاوز الدور "تغير دور المالك. تم رفض الطلبات التي تحتاج إلى القدرات المشطوب عليها."
تم الإلغاء / منتهي الصلاحية الرمز المميز لم يعد يعمل. يظهر السبب بجانبه (انظر لماذا توقف الرمز المميز عن العمل).

يتم إخفاء الرموز الملغاة ومنتهية الصلاحية افتراضياً. انقر على إظهار الملغاة ومنتهية الصلاحية (العدد) لسردها؛ تظل مدرجة لمدة 30 يوماً.

تغيير وصول الرمز المميز

لا يمكن تعديل أذونات الرمز المميز، أو المواقع، أو انتهاء الصلاحية، أو حدود الإنفاق، أو قائمة سماح عناوين IP بعد إنشائه. لتغيير أي منها، أنشئ رمزاً مميزاً جديداً بالإعدادات الجديدة، وقم بتحويل وكيلك إليه، ثم قم بإلغاء الرمز القديم.

إعادة إنشاء الرمز السري للرمز المميز

أعد الإنشاء عندما يكون هناك احتمال لتسريب الرمز السري، أو لتدويره وفق جدول زمني. الرمز السري الجديد له نفس الاسم، والوصول، والمواقع، وقائمة سماح عناوين IP، وحدود الإنفاق، وتاريخ انتهاء الصلاحية.

  1. افتح قائمة الرمز المميز

    في علامة التبويب الرموز، افتح قائمة ⋯ في صف الرمز المميز واختر إعادة إنشاء الرمز السري.

  2. اختر متى يتوقف الرمز السري القديم

    يسأل مربع الحوار "إعادة إنشاء "الاسم"؟": "ستحصل على رمز سري جديد بنفس الوصول. سيتوقف الرمز القديم عن العمل." حدد إبقاء الرمز السري القديم يعمل لمدة 24 ساعة إذا كان الوكلاء لا يزالون يستخدمونه وتحتاج إلى وقت لتحويلهم. اتركه غير محدد لإيقاف الرمز القديم فوراً.

  3. انسخ الرمز السري الجديد

    انقر على إعادة إنشاء. يعرض مربع الحوار تم إنشاء الرمز الرمز السري الجديد مرة واحدة. انسخه، وقم بتحديث وكيلك أو مخزن الرموز السرية، ثم انقر على لقد قمت بتخزينه.

قواعد إعادة الإنشاء:

  • الشخص الذي أنشأ الرمز المميز هو الوحيد الذي يمكنه إعادة إنشائه. يرى المالك أو المسؤول الذي لم ينشئه "الشخص الذي أنشأ هذا الرمز المميز هو الوحيد الذي يمكنه إعادة إنشائه. يمكنك إلغاؤه."
  • يمكن إعادة إنشاء الرمز السري مرة واحدة. بعد ذلك، يظهر الصف القديم "تم استبداله برمز سري معاد إنشاؤه" ولا يحتوي على خيار إعادة إنشاء الرمز السري؛ أعد إنشاء الرمز المميز الجديد بدلاً من ذلك. تؤدي المحاولة مرة أخرى على الرمز السري القديم إلى ظهور "تمت إعادة إنشاء هذا الرمز المميز بالفعل، أو إلغاؤه، أو انتهت صلاحيته؛ استخدم بديله أو أنشئ رمزاً جديداً."
  • تاريخ انتهاء الصلاحية لا يتغير. الرمز المميز الذي تم إنشاؤه لمدة 90 يوماً لا يزال ينتهي في تاريخه الأصلي. إذا كانت الـ 24 ساعة الخاصة بالرمز السري القديم ستتجاوز ذلك التاريخ، فإنه يتوقف عند تاريخ انتهاء الصلاحية.
  • يمكنك إعادة الإنشاء حتى عندما تكون مساحة العمل عند حد الرموز المميزة النشطة. خلال فترة التداخل التي تبلغ 24 ساعة، يعمل كلا الرمزين السريين ويُحسب كلاهما كرموز مميزة نشطة.
  • تتطلب إعادة الإنشاء أن تكون مساحة العمل على خطة Pro أو أعلى؛ وإلا فإن إعادة إنشاء الرمز السري ستفتح مربع حوار الترقية.

إلغاء رمز مميز

  1. افتح قائمة ⋯ في صف الرمز المميز واختر إلغاء.
  2. أكد باستخدام إلغاء الرمز المميز: "يفقد الوكلاء الذين يستخدمون هذا الرمز المميز الوصول فوراً. لا يمكن التراجع عن هذا."

يؤدي إلغاء الرمز المميز إلى إخلاء مكانه في حد الرموز المميزة النشطة لمساحة العمل على الفور.

انتهاء الصلاحية

كل رمز مميز له تاريخ انتهاء صلاحية. أنت تختار العمر الافتراضي عند إنشائه: 7 أيام، أو 30 يوماً، أو 90 يوماً (الافتراضي)، أو سنة واحدة. لا يوجد خيار "لا تنتهي صلاحيته أبداً"، لذا لا يمكن أن يظل الرمز المميز المنسي صالحاً إلى الأبد. يعرض عمود تنتهي صلاحيته التاريخ.

بعد تاريخ انتهاء الصلاحية، تُرجع كل مكالمة "انتهت صلاحية هذا الرمز المميز. أنشئ رمزاً جديداً في Integrations → AI agents & API." لا يمكن تجديد الرمز المميز منتهي الصلاحية أو إعادة إنشائه؛ أنشئ رمزاً جديداً.

قائمة السماح لعناوين IP

يمكن تقييد الرمز المميز بالعناوين التي يعمل منها وكيلك (على سبيل المثال، مشغل CI أو خادم). يمكنك تعيين ذلك في خطوة الحدود في المعالج تحت متقدم → قائمة السماح لعناوين IP: "اختياري. عنوان واحد أو نطاق واحد لكل سطر؛ يتم رفض المكالمات من أي مكان آخر."

  • أدخل عناوين IPv4 أو IPv6 (203.0.113.7) أو نطاقات بتنسيق CIDR (198.51.100.0/24)، بحد أقصى 20 إدخالاً.
  • اتركها فارغة للسماح بأي عنوان. تعرض خطوة المراجعة بعد ذلك أي عنوان.
  • تُرجع المكالمة من عنوان آخر "لا يمكن استخدام هذا الرمز المميز من عنوان IP هذا."
  • يتم رفض الإدخال الذي ليس عنواناً أو نطاقاً: "القيمة ليست عنوان IP أو نطاقاً."

لماذا توقف الرمز المميز عن العمل

يظهر على الرمز المميز ما حدث ما يجب فعله
منتهي الصلاحية انتهى عمره الافتراضي. أنشئ رمزاً مميزاً جديداً.
"تم الإلغاء من قبل مالكه" قام الشخص الذي أنشأه بإلغائه. أنشئ رمزاً مميزاً جديداً إذا كان لا يزال مطلوباً.
"تم الإلغاء من قبل مسؤول" قام مالك مساحة العمل أو مسؤول بإلغائه. اسألهم عن السبب قبل إنشاء رمز جديد.
"تم الإلغاء: غادر المالك مساحة العمل" تمت إزالة الشخص الذي أنشأه من مساحة العمل. تم إلغاء جميع رموزهم المميزة. يقوم شخص لا يزال في مساحة العمل بإنشاء رمز مميز جديد.
"تم الإلغاء: تم حذف حساب المالك" حذف المالك حسابه في Clevera. أنشئ رمزاً مميزاً جديداً.
"تم استبداله برمز سري معاد إنشاؤه" تمت إعادة إنشاء الرمز السري. استخدم الرمز السري الجديد.
"تم الإلغاء: تم العثور عليه في مستودع عام" تم العثور على الرمز المميز في مستودع GitHub عام وتم إلغاؤه تلقائياً. قم بإزالته من سجل المستودع، ثم أنشئ رمزاً مميزاً جديداً واحتفظ به في مخزن الرموز السرية.
"تم الإلغاء: نشاط غير معتاد" أجرى العديد من الطلبات المرفوضة في بضع دقائق (أكثر من 50 في 10 دقائق). تحقق من النشاط لمعرفة ما حاول القيام به، وأصلح الوكيل، ثم أنشئ رمزاً مميزاً جديداً.
"تم الإلغاء: تم اكتشاف إعادة استخدام الرمز المميز" / "تم الإلغاء: تم قطع اتصال التطبيق" تنطبق هذه على التطبيقات المتصلة، وليس رموز API. اتصل بالتطبيق مرة أخرى.
تُرجع كل مكالمة "وكيل API غير موجود في خطة مساحة العمل هذه. إنه موجود في Pro وما فوق." انتقلت مساحة العمل من Pro أو Business أو Custom. قم بالترقية إلى Pro. انظر إذا غادرت مساحة العمل خطة Pro.

نشاط غير معتاد

تراقب Clevera كل رمز مميز بحثاً عن دفعات وتخبر مالك مساحة العمل بإشعار "نشاط غير معتاد على الرمز المميز":

  • العديد من الطلبات المرفوضة في بضع دقائق: يتم إلغاء الرمز المميز. "أجرى العديد من الطلبات المرفوضة في بضع دقائق."
  • عدد كبير غير معتاد من التغييرات في بضع دقائق (أكثر من 200 عملية كتابة أو 20 عملية إزالة صفحة في 10 دقائق): تتوقف عمليات الكتابة الخاصة به لمدة 10 دقائق. تُرجع المكالمات "تم إيقاف عمليات الكتابة من هذا الرمز المميز مؤقتاً بعد دفعة غير معتادة من التغييرات. تم إخطار مالك مساحة العمل." لا تزال عمليات القراءة تعمل.
  • إنفاق الرصيد بسرعة غير معتادة: لا يمكن للرمز المميز بدء عمل مدفوع لمدة 24 ساعة. "أنفق عدداً كبيراً غير معتاد من الرصيد في بضع دقائق، لذا لا يمكنه بدء عمل مدفوع في الوقت الحالي."

إذا غادرت مساحة العمل خطة Pro

تتوفر ميزة AI agents & API في خطط Pro وBusiness وCustom. إذا انتقلت مساحة العمل إلى Starter أو Free، تعرض الصفحة "AI agents & API مضمنة في Pro": "قم بالترقية للسماح لـ Claude وChatGPT ونصوصك البرمجية بالعمل في مساحة العمل هذه. تتوقف الرموز المميزة والتطبيقات الحالية عن العمل حتى ذلك الحين؛ لا يزال بإمكانك إلغاؤها هنا."

  • تظل الرموز المميزة مدرجة ويمكن إلغاؤها، ولكن يتم رفض كل مكالمة بـ plan_locked.
  • تفتح إعادة إنشاء الرمز السري مربع حوار الترقية بدلاً من ذلك.
  • تؤدي الترقية مرة أخرى إلى Pro إلى جعل الرموز المميزة تعمل مرة أخرى. لا يتم حذف أي شيء؛ لا تزال الرموز المميزة تنتهي في تواريخها.