الواجهة البرمجية العامة في لوحة المعلومات
تقع الواجهة البرمجية العامة في مجموعة المنصة في شريط لوحة المعلومات، تحت الروابط والواجهة. تعرض ما يحتاجه نظام خارجي أو مساعد ذكاء اصطناعي ليصل إلى متجرك: العناوين المنشورة، وعملاء الواجهة النشطين، ومعرّفات مفاتيح أسرارهم. ولا تعرض أي سر. هي نظيرة شاشة الواجهة البرمجية العامة في المكتب الخلفي، وتقرأ المعلومات نفسها.
من يمكنه استخدام هذه الصفحة
Section titled “من يمكنه استخدام هذه الصفحة”مستخدم يملك الصلاحية api-clients-manage، في مؤسسة تشمل خطتها قدرة الواجهة البرمجية والتكاملات. وكما في الروابط والواجهة، تأتي الخطة أولًا: ما دامت القدرة مستبعدة يفتح المسار على شاشة الوحدة المقفلة لكل حساب مهما كانت صلاحياته.
قبل البدء
Section titled “قبل البدء”- راجع خطتك في صفحة الاشتراك.
- حدّد من سيستلم العناوين. العناوين ليست سرية، أما سر العميل فسري: لا تلصقه أبدًا في تذكرة دعم أو محادثة أو لقطة شاشة.
الخطوات
Section titled “الخطوات”- افتح الواجهة البرمجية العامة من مجموعة المنصة. تُفتح الصفحة على نظرة عامة.
- اقرأ البطاقات في الأعلى: العملاء النشطون الذين يمكنهم طلب رمز الآن؛ والعملاء الملغون الذين لا يُدرجون أدناه لأن الإلغاء نهائي؛ ومفاتيح سارية وهي أجيال الأسرار غير الملغاة لدى العملاء النشطين؛ والتطبيقات المتصلة وهي تطبيقات الذكاء الاصطناعي التي سجّلت الدخول بحساب أيدي الآن، مع ملاحظة تقول هل تسجيل دخول تطبيقات الذكاء الاصطناعي مفعّل؛ والواجهة العامة وتكون مفعّلة عندما يقبل عنوان الرمز الطلبات وموقوفة عندما أوقفها النشر.
- في الاتصال اختر نسخ بجانب عنوان الواجهة أو عنوان الرمز أو خادم MCP. ويقدّم عنوان التوثيق أيضًا زر فتح الذي يفتح مرجع الواجهة العامة في تبويب جديد. وعنوان خادم MCP هو ما تضيفه إلى تطبيق ذكاء اصطناعي مثل Claude، فيسجّل التطبيق الدخول بعدها بحساب أيدي.
- اقرأ جدول العملاء: كل العميل نشط مع الصلاحيات ونطاق فروعه (كل الفروع أو عدد الفروع)، ومفاتيح السر بتواريخ إصدارها وإلغائها، وتاريخ أُنشئ، وآخر استخدام الذي يظهر فيه «لا تسجّله المنصة» لأن آخر استخدام لا يُسجَّل بعد.
- اقرأ العمود الجانبي. يشرح كيف يتصل تطبيق الذكاء الاصطناعي والتكامل بين الخوادم، وأين تُدار العملاء والتطبيقات المتصلة.
التطبيقات المتصلة
Section titled “التطبيقات المتصلة”تظهر تطبيقات الذكاء الاصطناعي التي سجّلت الدخول بحساب أيدي في الإدارة، في بطاقة التطبيقات المتصلة تحت عملاء الواجهة. صفِّها بـ المتصلة أو المفصولة أو الكل. يعرض كل صف التطبيق مع معرَّف من مضيف أو غير موثّق، وعنوان عودته ومرجعه og_…؛ والصلاحيات والفروع؛ ومن سمح له (أنت، أو معرّف المستخدم الذي وافق)؛ والحالة وآخر استخدام وموعد انتهاء تسجيل دخوله.
- افتح الإدارة وابحث عن التطبيق في التطبيقات المتصلة.
- اختر فصل، واكتب السبب من ٥ إلى ٢٤٠ حرفًا، وأكّد.
يشرح الصف المفصول كيف انتهى: فصله مستخدم، أو سُجّل خروجه لأن تسجيل دخول قديمًا أُعيد استخدامه، أو سُجّل خروجه لأن رمز دخول لمرة واحدة استُخدم مرتين. والأخيران تلقائيان: قدّم شيء تسجيل دخول سبق استخدامه، فأنهت أيدي الاتصال احتياطًا. والموافقة على تطبيق مشروحة في الموافقة على تسجيل دخول تطبيق ذكاء اصطناعي.
تحقق من الشاشة
Section titled “تحقق من الشاشة”الملاحظة التحذيرية بعنوان «الواجهة العامة موقوفة في هذا النشر» تعني أن طلبات الرموز وكل استدعاء عام مرفوضة برد قابل لإعادة المحاولة حتى تُعاد، ويبقى العملاء ومفاتيحهم كما هم. والملاحظة بعنوان «خطتك لا تشمل الواجهة البرمجية» تعني أن عنوان الرمز لن يصدر رموزًا لعملائك حتى تشمل الخطة الميزة. والملاحظة بعنوان «تسجيل دخول تطبيقات الذكاء الاصطناعي غير مهيأ في هذا النشر بعد» تعني أن تطبيقات الذكاء الاصطناعي لا تستطيع تسجيل الدخول بعد؛ وإلى أن يُهيأ اتصل برمز عميل واجهة مطلوب مع resource مساوٍ لعنوان خادم MCP، كما تشرح اربط مساعد ذكاء اصطناعي بمتجرك.
ما دام الحساب للقراءة فقط، تستطيع عملاء الواجهة والتطبيقات المربوطة طلب الرمز والقراءة؛ أما كل كتابة ترسلها فتُرفض بالرمز tenant_suspended، ولا يمكن إنشاء عميل أو تعديله أو تدوير سرّه حتى تعيد أيدي تفعيل الحساب. ويسرد الكتالوج العام الأصناف مسعّرة لقناة بيع، هي أونلاين ما لم يسمِّ الاستدعاء غيرها، فيطابق السعر المعروض ما تُحاسَب به سلة الواجهة على تلك القناة؛ والصنف المخفي عن تلك القناة لا يُسرد.
إذا لم تنجح الخطوات
Section titled “إذا لم تنجح الخطوات”- إذا ظهر «تعذر تحميل إعدادات الواجهة البرمجية.»، فاختر إعادة المحاولة ثم تحقق من الاتصال والصلاحيات.
- إذا رفض المتصفح الوصول إلى الحافظة يظهر إشعار «تعذر النسخ»؛ حدّد العنوان وانسخه يدويًا.
- إذا فُتحت الوحدة على شاشة القفل، فالخطة تستبعد القدرة؛ راجع الوحدات المقفلة وحالات البيانات.