ربط منصة مخصصة وشرح ربط الطلبات والحقول
من اختبار الاتصال واستيراد Postman/OpenAPI إلى تحديد وظائف الطلبات وربط الحقول وتفعيل المزامنة.
مدة القراءة: 1 دقيقة · آخر تحديث 2026-11-21
الهدف من هذه الصفحة
تعريف كيفية قراءة Zervixo لواجهة API مخصصة، وأي طلب مسؤول عن عرض أو إنشاء أو تعديل أو حذف كل نوع بيانات.
من يستطيع الوصول
مسؤول الشركة الذي يملك صلاحية إدارة إعدادات الشركة.
الصلاحية المطلوبة
manage company settings
شرح الحقول
- وظيفة الطلب: تحدد ماذا يفعل الطلب واتجاهه ومتى يُستخدم. مثال: المنتجات — عرض القائمة مع GET لاستيراد المنتجات، أو المنتجات — تعديل مع PUT/PATCH لإرسال تحديث مدعوم.
- ربط الحقول: يأتي بعد اختيار الوظيفة ويحدد كيف تنتقل القيم داخل الطلب. مثال: data.items[*].sku ← SKU وdata.items[*].price ← سعر البيع؛ ولا يحدد وحده متى يعمل الطلب.
- مسار الحقل الخارجي: مكان القيمة داخل استجابة JSON، مثل data.items[*].id.
- حقل Zervixo: الحقل الداخلي المقابل الذي ستُحفظ فيه القيمة.
شرح الأزرار
- اختبر الاتصال: يفحص الرابط وبيانات المصادقة فقط، ولا يفعّل المزامنة.
- حفظ واقتراح الحقول: بعد اختيار الوظيفة يحفظها ويحلل JSON ليقترح عدة روابط تلقائيًا؛ مثال: sku ← SKU وprice ← سعر البيع.
- إضافة ربط جديد: يكمل يدويًا حقلًا لم يظهر في الاقتراح؛ مثال: data.items[*].barcode ← باركود المنتج، ولا يغير الوظيفة.
- تفعيل الاتصال والمزامنة: يبدأ المزامنة بعد وجود طلب مفعّل مربوط بوظيفة واحدة على الأقل.
دورة العمل
- أدخل بيانات الاتصال واضغط «اختبر الاتصال»، ثم أنشئ الاتصال.
- ارفع ملف Postman/OpenAPI أو أنشئ الطلبات يدويًا.
- اختر وظيفة كل طلب لتحديد ماذا يفعل ومتى يعمل؛ مثال: List Products مع GET لجلب المنتجات.
- اختبر الطلب للحصول على استجابة، ثم اربط حقول JSON بالحقول المقابلة في Zervixo عبر «حفظ واقتراح الحقول».
- راجع الاقتراحات وأضف أي ربط ناقص عبر «إضافة ربط جديد»؛ مثال: data.items[*].barcode مع باركود المنتج.
- فعّل الاتصال والمزامنة عندما تصبح الطلبات المطلوبة جاهزة.
سيناريو عملي
ملف Postman يحتوي List Products وCreate Order: يتعرف النظام غالبًا على الوظيفتين من الأسماء، ويقترح حقول المنتجات إذا وجد مثال JSON؛ يراجع المسؤول الاقتراحات ثم يضيف أي حقل ناقص يدويًا قبل التفعيل.
أخطاء محتملة وحلولها
- اختبار الاتصال نجح لكن التفعيل لا يعمل — الاختبار يثبت الرابط والمصادقة فقط. اربط طلبًا مفعّلًا بوظيفة مزامنة واحدة على الأقل أولًا.
- هل الربط تلقائي بالكامل؟ — يُقترح تلقائيًا عند وضوح اسم الطلب ووجود مثال استجابة، لكن يجب مراجعة الوظائف والحقول قبل التفعيل.
أسئلة شائعة
ما الفرق بين اختيار وظيفة الطلب وربط الحقول؟
الوظيفة تحدد ماذا يفعل الطلب واتجاهه ومتى يستخدمه النظام؛ مثال: Products — List مع GET لجلب المنتجات. ربط الحقول يحدد كيف تنتقل القيم داخل نفس الطلب؛ مثال: data.items[*].sku إلى SKU وdata.items[*].price إلى سعر البيع. تحتاج الاثنين لمزامنة صحيحة.
ما الفرق بين «حفظ واقتراح الحقول» و«إضافة ربط جديد»؟
بعد اختيار الوظيفة، «حفظ واقتراح الحقول» يحفظها ويقترح عدة روابط تلقائيًا من JSON، مثل sku إلى SKU وprice إلى سعر البيع. «إضافة ربط جديد» يكمل يدويًا حقلًا واحدًا لم يظهر في الاقتراح، مثل data.items[*].barcode إلى باركود المنتج.
هل ربط عرض المنتجات يفعّل إنشاءها وتعديلها وحذفها؟
لا. كل عملية لها طلب مستقل ووظيفة مستقلة، ولا تُفعّل إلا العمليات التي ربطتها فعليًا.
هل يجب ربط GET وPOST وPUT وDELETE كلها؟
لا. ابدأ بـGET لجلب البيانات دوريًا إلى Zervixo. اربط POST أو PUT/PATCH فقط إذا أردت عمليات تصدير مدعومة إلى منصتك. DELETE ليس مطلوبًا للمزامنة الأساسية ولا يعمل تلقائيًا ضمن الجلب الدوري.