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