مرجع الواجهة البرمجية العامة في لوحة المعلومات

هذه الصفحة مرجع الحقول لصفحة الواجهة البرمجية العامة في لوحة معلومات التاجر، وهي ما يفتحه زر مساعدة أعلى الصفحة في تبويب جديد. تُنشأ عملاء الواجهة وتُعدَّل وتُدوَّر أسرارها وتُلغى في الإدارة في الصفحة نفسها، أو في المكتب الخلفي، الإعداد ثم المطورون. ولخطوات العمل راجع الواجهة البرمجية العامة في لوحة المعلومات.

الحقول

الغرض من الشاشة: تعرض «نظرة عامة» ما يحتاجه تطبيق ذكاء اصطناعي أو نظام خارجي ليتصل بأيدي: عنوان الواجهة وعنوان الرمز وخادم MCP الذي تستضيفه أيدي والتوثيق، مع العملاء النشطين ومعرّفات مفاتيحهم وعدد التطبيقات المتصلة، ولا تعرض أي سر. تطبيق الذكاء الاصطناعي يتصل بإضافة عنوان خادم MCP فيه وتسجيل الدخول؛ أما عملاء الواجهة والرموز الحاملة فللتكامل بين الخوادم. وفي «الإدارة» تُدار العملاء كاملة: الإنشاء مع إظهار السر مرة واحدة، والتعديل، وتدوير السر، وإلغاء مفتاح واحد، وإلغاء العميل؛ وتُعرض التطبيقات المتصلة وتُفصل. يمكن إدارة العملاء أيضًا من المكتب الخلفي، الإعداد ثم المطورون.

التنبيهات والبطاقات

الحقل	المعنى
الواجهة العامة موقوفة في هذا النشر	ملاحظة تحذيرية تظهر عندما يوقف النشر الواجهة العامة: يرد عنوان الرمز وكل مسار عام برفض قابل لإعادة المحاولة حتى تُعاد، ويبقى العملاء ومفاتيحهم كما هم.
خطتك لا تشمل الواجهة البرمجية	ملاحظة تحذيرية تظهر عندما لا تشمل الخطة ميزة الواجهة البرمجية، فلا يُصدر عنوان الرمز رموزًا لعملائك. الترقية من صفحة الاشتراك.
تسجيل دخول تطبيقات الذكاء الاصطناعي غير مهيأ في هذا النشر بعد	ملاحظة تحذيرية تظهر عندما يكون خادم MCP منشورًا لكن تسجيل الدخول إليه غير مهيأ. إلى أن يُهيأ، يتصل التطبيق برمز حامل من عميل واجهة يُطلب لعنوان خادم MCP.
العملاء النشطون	عدد عملاء الواجهة النشطين، أي الذين يمكنهم طلب رمز الآن.
العملاء الملغون	عدد العملاء الملغين. الإلغاء نهائي، ولا يُدرجون في الجدول.
مفاتيح سارية	عدد أجيال الأسرار غير الملغاة عبر العملاء النشطين. يكون للعميل أكثر من مفتاح سارٍ أثناء التدوير حتى يُلغى القديم.
التطبيقات المتصلة	عدد تطبيقات الذكاء الاصطناعي المتصلة الآن، وتحته هل تسجيل دخول تطبيقات الذكاء الاصطناعي مفعّل في هذا النشر.
الواجهة العامة	«مفعّلة» عندما يقبل عنوان الرمز الطلبات، و«موقوفة» عندما أوقفها النشر.

الاتصال

الحقل	المعنى
عنوان الواجهة	الأصل الذي تبدأ منه كل المسارات العامة. يظهر كما ضبطه النشر، مع زر «نسخ». إذا لم يُضبط تظهر «غير مهيأ في هذا النشر» بلا زر نسخ.
عنوان الرمز	العنوان الذي يرسل إليه النظام الخارجي معرّف العميل وسرّه ليحصل على رمز حامل بمنحة بيانات العميل. يُشتق من عنوان الواجهة.
خادم MCP	خادم MCP تستضيفه أيدي. أضف هذا العنوان في تطبيق الذكاء الاصطناعي لديك (مثل Claude) وسجّل الدخول بحساب أيدي، فيفتح التطبيق صفحة موافقة تختار فيها الصلاحيات والفروع. عملاء الواجهة والرموز الحاملة مخصصة للتكامل بين الخوادم. يظهر «غير مهيأ في هذا النشر» إن لم يُضبط.
التوثيق	مرجع العمليات العامة وصلاحياتها، مع زر «فتح» في تبويب جديد وزر «نسخ» عندما يكون مضبوطًا.
نسخ	ينسخ العنوان إلى الحافظة ويؤكد ذلك بإشعار. إذا منع المتصفح الوصول إلى الحافظة تظهر رسالة لتنسخ العنوان يدويًا.

جدول العملاء النشطين

الحقل	المعنى
العميل	اسم العميل، وتحته معرّف العميل الذي يُضبط به النظام الخارجي ونطاق الفروع: كل الفروع أو عدد الفروع المقيّد بها.
الصلاحيات	الصلاحيات الممنوحة للعميل، وتُقرأ من جديد مع كل طلب.
مفاتيح السر	معرّف كل جيل من أسرار العميل وتاريخ إصداره، وتاريخ إلغائه إن أُلغي (يظهر مشطوبًا). السر نفسه لا يظهر هنا أبدًا.
أُنشئ	تاريخ إنشاء العميل.
آخر استخدام	لا تسجّل المنصة وقت آخر استخدام للعميل، فيقول العمود ذلك بدل أن يعرض تقديرًا.

العمود الجانبي

الحقل	المعنى
ربط نظام خارجي	يلخّص الربط: تطبيق الذكاء الاصطناعي يتصل بعنوان خادم MCP ويسجّل الدخول؛ والتكامل بين الخوادم يستخدم نوع المنحة client_credentials وترويسة Authorization بالرمز الحامل. ويذكر مكان إدارة العملاء.
إنشاء العملاء وتعديلهم وتدوير أسرارهم وإلغاؤهم من «الإدارة»	تُدار العملاء هنا في «الإدارة» أو في المكتب الخلفي، الإعداد ثم المطورون.
التطبيقات المتصلة تُدار من «الإدارة»	كل تطبيق سمح له مستخدم يظهر في «الإدارة» ضمن التطبيقات المتصلة، ويُفصل هناك بسبب مكتوب.
تعذر تحميل إعدادات الواجهة البرمجية.	حالة خطأ تحل محل الصفحة عندما تفشل القراءة، مع السبب وزر «إعادة المحاولة». لا تُعرض عناوين أو عملاء مخمَّنون.

الإدارة

الحقل	المعنى
عميل واجهة جديد	الإجراء الرئيسي في «الإدارة». نافذة فيها الاسم (من ٣ إلى ١٦٠ حرفًا)، والفروع («كل الفروع» أو فروع بعينها)، والصلاحيات؛ لكل صلاحية وصف سطر واحد ومفتاح الخطة الإضافي إن احتاجته.
احفظ سر العميل	تظهر بعد الإنشاء أو التدوير: معرّف العميل ومعرّف المفتاح والسر، ولكل منها زر نسخ. لن ترى السر مرة أخرى، ولا تُغلق النافذة إلا بزر «حفظت السر».
إعادة المحاولة	إن لم تُجب أيدي أثناء الإنشاء أو التدوير ترسل «إعادة المحاولة» الطلب نفسه بالمفتاح نفسه، فإن كان قد نُفّذ تعود البيانات والسر نفسها خلال ٢٤ ساعة ولا يُنشأ عميل ثانٍ. بعدها، أو بعد إلغاء المفتاح، لا يُعرض السر ودوّره لتحصل على سر جديد.
تعديل العميل · تدوير السر · إلغاء العميل	التعديل يغيّر الاسم والصلاحيات والفروع بسبب مكتوب ونسخة العميل الحالية، ويسري من الطلب التالي. التدوير يصدر سرًا جديدًا يظهر مرة واحدة ويبقى القديم صالحًا حتى تلغيه. إلغاء العميل نهائي ويحتاج سببًا.
مفاتيح السر · إلغاء المفتاح	كل مفتاح للعميل المختار بمعرّفه وتاريخ صدوره وحالته. «إلغاء المفتاح» يطلب التأكيد ويوقف ذلك المفتاح وحده، ويحذّر إن كان الصالح الأخير.
التطبيقات المتصلة	جدول تطبيقات الذكاء الاصطناعي التي سمح لها مستخدم في مؤسستك عبر تسجيل الدخول: اسم التطبيق مع «غير موثّق» لتطبيق سجّل نفسه بنفسه أو «معرَّف من» ومضيفه، والعنوان الذي يعود إليه، والصلاحيات، والفروع، ومن سمح له («أنت» أو معرّف المستخدم)، وآخر استخدام وتاريخ الانتهاء.
المتصلة · المفصولة · الكل	تصفّي الجدول، مع العدد في كل خيار. التطبيق المفصول يعرض تاريخ الفصل وسببه المكتوب ومعناه، مثل «فصله مستخدم» أو «سُجّل خروجه لأن تسجيل دخول قديمًا أُعيد استخدامه».
فصل	يفتح نافذة تأكيد تطلب سببًا من ٥ إلى ٢٤٠ حرفًا يُسجَّل في سجل التدقيق. يتوقف تسجيل دخول التطبيق مع طلبه التالي؛ ولإعادة الربط سجّل الدخول من التطبيق من جديد.