عملاء الواجهة في قسم المطورين

عميل الواجهة هو طريقة اتصال نظام خارجي بمتجرك عبر الواجهة البرمجية العامة، مثل تصدير المحاسبة أو متجر إلكتروني أو مساعد ذكاء اصطناعي. لكل عميل معرّف، ومفتاح سر واحد أو أكثر، وصلاحيات تحدد ما يستطيعه، وتقييد اختياري بفروع. قسم المطورون في مجموعة الإعداد هو مكان إنشاء العملاء وإدارتهم في تطبيق نقطة البيع؛ وتقدّم لوحة معلومات التاجر الإجراءات نفسها في الواجهة البرمجية العامة، الإدارة (راجع إدارة عملاء الواجهة في لوحة المعلومات).

من يمكنه استخدام هذه الصفحة

حساب يملك الصلاحية api-clients-manage، في مؤسسة تشمل خطتها قدرة الواجهة البرمجية والتكاملات. ومن دون تلك الصلاحية لا يظهر المطورون في الشريط. من دون الخطة تبقى الشاشة مقروءة، لكن عميل واجهة جديد وكل تغيير آخر مقفل، ويظهر تنبيه الخطة باسم الميزة integrations.api وزر عرض الخطة والفواتير.

قبل البدء

• اتصال بالإنترنت؛ كل إجراء هنا يُرسل إلى الخادم فورًا.
• معرفة واضحة بما يحتاجه النظام الخارجي، لتمنحه أقل الصلاحيات التي تكفي.
• مكان آمن لحفظ السر، مثل مدير كلمات المرور في مؤسستك أو مخزن الأسرار لدى مسؤول التكامل. يظهر السر مرة واحدة فقط.

إنشاء عميل

1. افتح المطورون من مجموعة الإعداد واختر عميل واجهة جديد.
2. أدخل اسمًا للعميل من ٣ إلى ١٦٠ حرفًا، مثل «تصدير المحاسبة». لا يراه إلا فريقك.
3. علّم الصلاحيات التي يحتاجها النظام. كل صلاحية تشرح بكلمات واضحة ما تفتحه، وبعضها يذكر ميزة الخطة التي يحتاجها أيضًا:
   • قراءة العملاء وإنشاء العملاء وتحديثهم تحتاجان أيضًا مفتاح الخطة crm.
   • قراءة المخزون تحتاج أيضًا inventory.advanced.
   • قراءة التقارير تحتاج analytics.advanced لتقارير التحليلات فقط؛ أما تقرير المبيعات فيعمل في كل خطة تشمل الواجهة.
   • قراءة التجهيز وتحديث التجهيز وإدارة الويبهوك مقبولة، لكن لا تستخدمها أي عملية عامة بعد، فمنحها لا يغيّر شيئًا اليوم.
4. تحت نطاق الفروع اترك كل الفروع ليصل العميل إلى كل فرع، ومنها ما يُضاف لاحقًا، أو اختر فروعًا لتقييده.
5. اختر إنشاء العميل.

الخطوات من ٢ إلى ٥: نافذة **عميل واجهة جديد** و**قراءة الطلبات** و**قراءة التقارير** معلّمتان. تعرض كل بطاقة مفتاح الصلاحية، ومفتاح الخطة الإضافي حيث يلزم. جميع البيانات المعروضة خيالية، بحجم `1366 × 768`.

نسخ السر في المرة الوحيدة التي يظهر فيها

بمجرد إنشاء العميل تُفتح نافذة انسخ السر الآن. تعرض معرّف العميل ومعرّف المفتاح وسر العميل، ولكل منها زر نسخ.

1. انسخ معرّف العميل والسر إلى مخزن الأسرار لديك.
2. اختر حفظت السر لإغلاق النافذة. لمس ما خارجها لا يغلقها.

نافذة **انسخ السر الآن**: التحذير بأن السر لن يظهر مرة أخرى، والقيم الثلاث بزر **نسخ**، وزر **حفظت السر**. القيم بيانات اختبار، بحجم `1366 × 768`.

النتيجة المتوقعة

يظهر العميل في قائمة عملاء الواجهة بحالة نشط، ويقول تنبيه إن العميل أُنشئ وظهر سرّه مرة واحدة. لا تحتفظ أيدي إلا بتجزئة السر، فلا يستطيع أحد أن يعرضه لك ثانية؛ فإن ضاع فدوّر السر.

إذا لم تُجب أيدي

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

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

بعد ضياع الرد تحتفظ نافذة **عميل واجهة جديد** بالنموذج وتقدّم **إعادة المحاولة**؛ والعميل الذي أنشأته المحاولة الأولى ظاهر في القائمة خلفها. جميع البيانات المعروضة خيالية، بحجم `1366 × 768`.

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

تعديل عميل

1. اختر العميل من قائمة عملاء الواجهة ثم اختر تعديل العميل.
2. غيّر الاسم أو الصلاحيات أو الفروع.
3. أدخل سبب التغيير من ٥ إلى ٢٤٠ حرفًا ثم اختر حفظ التغييرات.

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

شاشة **المطورون**: زر **عميل واجهة جديد** في الأعلى، وقائمة **عملاء الواجهة**، وتفاصيل العميل المحدد وصلاحياته وبداية **مفاتيح السر**. جميع البيانات المعروضة خيالية، بحجم `1366 × 768`.

تدوير السر وإلغاء المفاتيح القديمة

1. اختر العميل ثم تدوير السر. تعرض نافذة انسخ السر الآن السر الجديد مرة واحدة؛ احفظه واختر حفظت السر. وإذا لم تُجب أيدي فاختر إعادة المحاولة كما سبق.
2. انقل كل نظام يستخدم العميل إلى السر الجديد. يبقى السر السابق صالحًا حتى تلغيه.
3. تحت مفاتيح السر اختر إلغاء المفتاح على المفتاح القديم وأكّد. وإذا كان المفتاح الصالح الوحيد للعميل، ينبّهك التأكيد إلى أن العميل لن يحصل على رمز حتى تدوّر سرًا جديدًا.

جدول **مفاتيح السر** بمفتاحين صالحين، لكل منهما **إلغاء المفتاح**، ثم **تعديل العميل** و**تدوير السر** و**إلغاء العميل** في بطاقة العمليات. جميع البيانات المعروضة خيالية، بحجم `1366 × 768`.

النتيجة المتوقعة

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

إلغاء عميل

1. اختر العميل، وفي بطاقة العمليات أدخل سببًا من ٥ إلى ٢٤٠ حرفًا في حقل السبب.
2. اختر إلغاء العميل. يسري فورًا، ولا توجد نافذة تأكيد منفصلة.

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

إذا لم تنجح الخطوات

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

صفحات مرتبطة

• مرجع المطورين
• إدارة عملاء الواجهة في لوحة المعلومات
• الواجهة البرمجية العامة في المكتب الخلفي
• اربط مساعد ذكاء اصطناعي بمتجرك
• الإعدادات