ملخص شامل للمنتجات المسحوبة، حالة التوفر، مساحات العمل، والتتبع الدوري
إجمالي المنتجات المسحوبة
0
شاملة الألوان والموديلات
منتجات متوفرة (In Stock)
0
0 إجمالي المقاسات
منتجات نافدة (Out of Stock)
0
0 منتج عليه خصم
مساحات العمل والبروكسي
0
0 بروكسي نشط | تتبع كل 12 ساعة
| المنتج | مساحة العمل | الحدث | السعر | التوفر | الوقت |
|---|---|---|---|---|---|
| لا توجد تغيرات مسجلة بعد | |||||
| النوع | المنتجات المفحوصة | الفحص | تغير سعر/توفر | الملخص | الوقت |
|---|---|---|---|---|---|
| لا توجد سجلات تتبع بعد | |||||
أدخل رابط المنتج (أو عدة روابط) ليقوم النظام بسحب كافة التفاصيل، المقاسات، الباركود، والألوان المرتبطة
استعراض وإدارة المنتجات، تحديد وإرسال المنتجات إلى Webhook المتجر، وتصدير ملفات Excel
يقوم المجدول بفحص المنتجات تلقائياً كل فترة محددة (مثلاً كل 12 ساعة) وإرسال التحديثات للمتاجر المرتبطة عبر الـ Webhook
| المنتج | المساحة | الحدث | السعر السابق ← الجديد | التوفر | التاريخ | الإجراءات |
|---|
| # | المشغل | المنتجات المفحوصة | تم فحص | تغير سعر | تغير توفر | حالة الـ Webhook | التاريخ |
|---|
أنشئ مساحة عمل خاصة بكل مشروع أو متجر (مشروع A، مشروع B...) مع مفتاح API مستقل ورابط Webhook لإرسال المنتجات وتحديثات التوفر
فتح Swagger API التفاعلي يمكن لأي مشروع خارجي (مثل مشروع A) الاتصال بمساحة العمل الخاصة به باستخدام ترويسة X-API-Key: <WORKSPACE_API_KEY> أو Authorization: Bearer <WORKSPACE_API_KEY>:
GET
/api/v1/products?page=1&per_page=50&in_stock=true
جلب كافة منتجات مساحة العمل مع المقاسات والباركود والألوان المرتبطة والأسعار
GET
/api/v1/products/{id}
جلب تفاصيل منتج محدد مع جميع الألوان الشقيقة في نفس الـ Product Group
GET
/api/v1/product-groups/{product_group_id}
جلب جميع منتجات الألوان المرتبطة بمجموعة منتج واحدة
POST
/api/v1/scrape
إرسال رابط منتج من المتجر ليتم سحبه مع جميع ألوانه ومقاساته وإرجاع بياناته فوراً
POST
/api/v1/sync
طلب تحديث فوري لأسعار وحالة توفر المنتجات في مساحة العمل
GET
/api/v1/updates?limit=50
جلب آخر التغييرات في الأسعار وحالة التوفر للمزامنة السريعة
curl -X GET "http://127.0.0.1:8000/api/v1/products?in_stock=true" \
-H "X-API-Key: YOUR_WORKSPACE_API_KEY"
تحكم في وقت التتبع الدوري، سلوك سحب الألوان، وإدارة الـ 100 بروكسي الخاصة بحسابك في Webshare.io (يُحفظ المفتاح بأمان داخل ملف .env)
| # | العنوان (IP:Port) | الدولة | الحالة | نجاح / فشل | السرعة (Latency) | آخر استخدام | فحص الاتصال |
|---|---|---|---|---|---|---|---|
| لا توجد بروكسيات مضافة بعد — اضغط "مزامنة من Webshare" أو "لصق قائمة" | |||||||
.env
إضافة مستخدمين وتخصيص صلاحية الوصول لمشروع واحد أو عدة مشاريع بنفس الوقت (مع حصر الإعدادات التقنية والـ Webhook والبروكسي بمسؤول النظام)
| # | البريد الإلكتروني (الدخول) | الاسم الكامل | الصلاحية (Role) | المشاريع المصرح بها (Workspaces) | الحالة | آخر دخول | إجراءات |
|---|
مرجع تفصيلي كامل لـ Content ID و Group ID، آلية سحب المنتجات والألوان، التتبع الدوري، المزامنة عبر الـ Webhook، ووظيفة كل زر في اللوحة
Content ID و Group ID ومن أين يتم تسجيلهما؟
يُستخرجان تلقائياً 100% بدون إدخال يدوي
عندما تضع أي رابط منتج من Trendyol في صفحة السحب، يقوم محرك السحب تلقائياً بقراءة شيفرة المنتج وبياناته الداخلية (`JSON-LD` + `HTML Hydration State`) واستخراج كل المعرفات وحفظها في قاعدة البيانات بدون أي تدخل يدوي منك:
https://www.trendyol.com/en/ Avva / men-polo-neck-t-shirt -p-813697254?boutiqueId=61
813697254 = هو الـ
Content ID (الرقم الموجود مباشرة بعد -p- في الرابط، ويمثل هذا اللون تحديداً).
أما الـ Group ID فيُستخرج تلقائياً من داخل بيانات صفحة المنتج ليربط كل الألوان ببعضها!
| المعرّف (ID) | ما هو؟ وما وظيفته في المنصة؟ | من أين يستخرجه النظام؟ | مثال واقعي | كيف تستفيد منه في لوحة التحكم والـ API؟ |
|---|---|---|---|---|
Content ID |
المعرّف الفريد للون الواحد (المنتج المفرد). في Trendyol، كل لون من نفس القميص يمتلك صفحة مستقلة و Content ID خاصاً به.
|
يُستخرج تلقائياً من الرابط بعد علامة -p- ومن حقل contentId داخل بيانات الصفحة.
|
813697254 (اللون الأسود)813697299 (اللون الكحلي) |
يُستخدم لمنع تكرار نفس المنتج داخل مساحة العمل، ولتحديث السعر والمقاسات لهذا اللون تحديداً عند الفحص الدوري. |
Group ID(Product Group ID) |
معرّف عائلة الألوان المشتركة لنفس الموديل. جميع ألوان نفس المنتج (أسود، أبيض، كحلي، أحمر) تشترك في Group ID واحد يجمعها تحت مظلة موديل واحد.
|
يُستخرج تلقائياً من كائن المنتج الداخلي productGroupId في Trendyol، ثم يستدعي النظام API المجموعة لجلب بقية الألوان.
|
49201844(يجمع 5 ألوان مختلفة لنفس الموديل) |
يمكنك النقر على شارة Group: #... في أي منتج لفلترة وعرض جميع ألوانه الشقيقة فوراً، أو طلبها برمجياً عبر /api/v1/product-groups/{group_id}.
|
Item Number(Variant ID) |
معرّف المقاس الفرعي داخل اللون الواحد. كل مقاس ( S, M, L, XL) له رقم عنصر خاص به وحالة توفر مستقلة.
|
يُستخرج تلقائياً من مصفوفة المقاسات variants لكل لون مسحوب.
|
109482711 (مقاس M)109482712 (مقاس L) |
يظهر في جدول المقاسات داخل نافذة «التفاصيل» وفي ملف الـ Excel والـ Webhook لمعرفة أي مقاس نفد وأي مقاس متوفر. |
Barcode / SKU |
الباركود العالمي للمقاس أو كود الموديل التجاري الخاص بالعلامة التجارية. |
يُستخرج تلقائياً من بيانات المقاس والـ productCode في الصفحة.
|
8683791204912 |
أساسي لربط المخزون مع أنظمة المستودعات والمتاجر الإلكترونية (Shopify / WooCommerce / Salla / المتاجر الخاصة). |
شرح الأزرار في كافة التبويبات
| الزر / الأداة | المكان (التبويب) | الوظيفة التفصيلية وماذا يحدث عند الضغط عليه؟ | الصلاحية المطلوبة |
|---|---|---|---|
|
|
سحب منتج جديد (سوتش التبديل الأول) |
عند اختيار هذا السوتش، يقوم السكربت بسحب الرابط الذي وضعته، ثم يكتشف الـ Group ID الخاص به ويسحب جميع الألوان الأخرى المرتبطة بنفس الموديل تلقائياً مع مقاسات وصور وسعر كل لون (يتعطل الخيار الثاني تلقائياً لأنهما يعملان كسوتش تبديل).
|
جميع المستخدمين |
|
|
سحب منتج جديد (سوتش التبديل الثاني) |
يسحب فقط اللون الموجود في الرابط المدخل مع مقاساته وصوره وسعره، ويكتفي بحفظ روابط الألوان الأخرى كمرجع دون سحبها كمنتجات منفصلة. | جميع المستخدمين |
|
|
المنتجات / سجل التتبع (بطاقة المنتج أو الجدول) |
يفتح نافذة منبثقة شاملة تعرض معرض صور المنتج عالي الدقة، شريط الألوان الشقيقة (مع إمكانية التبديل بينها أو سحب أي لون غير مسحوب بضغطة زر)، جدول المقاسات والباركود، المواصفات الفنية، وسجل تغيرات السعر والمخزون التاريخي. | جميع المستخدمين |
|
|
بطاقة المنتج / جدول التتبع | يتصل فوراً بـ Trendyol لفحص هذا المنتج تحديداً وتحديث سعره الحالي، نسبة الخصم، وحالة توفر كل مقاس، ويسجل أي تغيير في السعر أو المخزون في سجل التتبع. | جميع المستخدمين |
|
|
تتبع المنتجات والمزامنة (شريط التحديد المتعدد) |
بعد تحديد عدة منتجات من جدول التتبع عبر مربعات الاختيار (Checkboxes)، يضغط المستخدم على هذا الزر لإعادة فحص وتتبع جميع المنتجات المحددة دفعة واحدة من Trendyol. | جميع المستخدمين |
|
|
المنتجات / تتبع المنتجات (شريط التحديد أو زر السطر) |
يرسل بيانات المنتجات المحددة الحالية فوراً (بصيغة JSON موقعة بـ HMAC) إلى رابط الـ Webhook المربوط بمساحة العمل ليتم إضافتها أو تحديثها في المتجر الخارجي. | مسؤول النظام حصراً |
|
|
المنتجات / تتبع المنتجات (شريط التحديد المتعدد) |
يقوم بخطوتين متتاليتين بضغطة واحدة: أولاً يسحب أحدث سعر وتوفر مقاسات للمنتجات المحددة من Trendyol، ثم يرسل البيانات المحدثة فوراً إلى Webhook المتجر. | مسؤول النظام حصراً |
|
|
الرئيسية / المنتجات / مساحات العمل | يُنشئ ملف إكسل احترافي منسق يحتوي على ورقتين (Sheet 1: كافة المنتجات مع الأسعار والروابط والـ Group ID، و Sheet 2: تفصيل كل مقاس وباركود وحالة التوفر) حسب الفلتر أو المشروع النشط. | جميع المستخدمين |
تلقائي + يدوي
| الآلية / العملية | كيف تعمل متى يتم تشغيلها؟ | نوع الحدث المرسل للـ Webhook (Event Type) | تفاصيل تقنية وملاحظات هامة |
|---|---|---|---|
| 1. الإرسال التلقائي عند السحب (Auto Webhook on Scrape) |
عند سحب منتج جديد (أو مجموعة ألوان) وتفعيل خيار «إرسال إشعار Webhook للمشروع بعد السحب»، يتم إرسال المنتجات فور انتهاء السحب تلقائياً. | products.scraped |
يحتوي الـ Payload على مصفوفة بجميع المنتجات المسحوبة وصورها ومقاساتها والـ product_group_id والـ content_id.
|
| 2. التتبع الدوري التلقائي في الخلفية (Background Auto-Tracker) |
يعمل المجدول الذكي في الخلفية لفحص المنتجات التي حان موعد فحصها (مثلاً كل 12 ساعة حسب إعدادات كل مشروع). وعند اكتشاف تغير في السعر أو نفاد/توفر مقاس، يرسل إشعاراً تلقائياً للمتجر. | products.tracking_updates |
يرسل فقط التغييرات المكتشفة (السعر القديم مقابل السعر الجديد، حالة التوفر القديمة مقابل الجديدة، وتفاصيل المقاسات الحالية). |
| 3. التحديد والإرسال اليدوي المجمع (Manual Bulk Selection & Sync) |
يمكنك تحديد منتج واحد أو عشرات المنتجات من تبويب «المنتجات» أو «تتبع المنتجات» أو إرسال كافة منتجات المشروع دفعة واحدة في أي وقت. | products.manual_push |
يدعم خيار الإرسال المباشر من قاعدة البيانات أو خيار «تحديث من Trendyol أولاً ثم الإرسال» لضمان دقة السعر والمخزون 100%. |
| 4. نظام الصلاحيات وتعدد المشاريع (Multi-Project Role System) |
يمكن لمسؤول النظام منح أي مستخدم عادي صلاحية الوصول إلى مشروع واحد أو أكثر من مشروع بنفس الوقت (أو جميع المشاريع). | X-API-Key لكل مشروع |
المستخدم العادي: ينشئ مساحات عمل، يسحب المنتجات، يتتبع الأسعار والمخزون، ويصدّر Excel. مسؤول النظام (Admin): ينفرد بإعدادات الـ Webhook، مفاتيح الـ API، بروكسيات Webshare.io، وإدارة المستخدمين (وتظهر هذه الأزرار معطلة للمستخدم العادي مع عبارة لمسؤول النظام حصراً). |