API المنتجات

إنشاء وقراءة وتحديث وحذف المنتجات في الكتالوج الخاص بك.

نقاط النهاية

GET

/products

products:read

استرجاع قائمة مرقمة من المنتجات. يدعم التصفية حسب الحالة والفئة والبحث.

GET

/products/:id

products:read

استرجاع منتج واحد بواسطة معرفه.

POST

/products

products:write

إنشاء منتج جديد في الكتالوج الخاص بك.

PUT

/products/:id

products:write

تحديث منتج موجود. التحديثات الجزئية مدعومة.

DELETE

/products/:id

products:write

حذف ناعم للمنتج. يمكن استعادته خلال 30 يوماً.

مرجع الحقول

الحقل	النوع	مطلوب	الوصف
id	string	لا	معرف المنتج الفريد (للقراءة فقط)
sku	string	نعم	وحدة حفظ المخزون
name	string	نعم	اسم المنتج
description	string	لا	وصف المنتج (HTML مسموح)
barcode	string	لا	الرمز الشريطي الرئيسي للمنتج (UPC/EAN)
brand	string	لا	اسم علامة المنتج التجارية
categoryId	string	لا	معرف الفئة
unitPrice	integer	نعم	السعر بالسنتات (مثال: 1999 = $19.99)
normalPrice	integer	لا	السعر العادي / سعر القائمة بالسنت (لعرض الخصومات)
purchasePrice	integer	لا	سعر الشراء / التكلفة بالسنت
weight	string	لا	الوزن بالجرام
isActive	boolean	لا	هل المنتج نشط / منشور (الافتراضي: true)
stockTotal	integer	لا	إجمالي المخزون المتاح عبر جميع المستودعات (للقراءة فقط)
images	string[]	لا	روابط صور المنتج
createdAt	datetime	لا	طابع زمني ISO 8601 (للقراءة فقط)
updatedAt	datetime	لا	طابع زمني ISO 8601 (للقراءة فقط)

معاملات الاستعلام (القائمة)

الحقل	النوع	مطلوب	الوصف
page	integer	لا	رقم الصفحة (افتراضي: 1)
limit	integer	لا	عناصر لكل صفحة (افتراضي: 20، حد أقصى: 100)

مثال

عرض المنتجات مع ترقيم الصفحات

bash

curl "https://api.mercozy.com/api/v1/external/products?page=1&limit=10" \
  -H "X-API-Key: mk_live_your_key_here"

إنشاء منتج

bash

curl -X POST "https://api.mercozy.com/api/v1/external/products" \
  -H "X-API-Key: mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "WDG-001",
    "name": "Premium Widget",
    "unitPrice": 2999,
    "normalPrice": 3999,
    "brand": "Acme Corp",
    "isActive": true
  }'