مصدر كتالوج المنتج المخصص

يجب أن تكون الاستجابة من نقطة نهاية API عبارة عن مصفوفة من كائنات المنتج، كل منها يحتوي على عدة حقول. إليك الهيكل والقيم النموذجية لكل حقل:

الحقول المطلوبة:

• id (سلسلة نصية): معرف فريد للمنتج. مثال: "8890650190078"

• name (سلسلة نصية): اسم المنتج. مثال: "My Test Product"

• description (سلسلة نصية): وصف المنتج. مثال: "منتج رائع مع أضواء متاحة بألوان مختلفة"

• status (سلسلة نصية): الحالة الحالية للمنتج. القيم الصالحة هي: active: المنتج متاح ويعمل.archived: المنتج مؤرشف.draft: المنتج في وضع المسودة. مثال: "active"

• created_at (سلسلة نصية): التاريخ والوقت عندما تم إنشاء المنتج، بتنسيق ISO-8601. مثال: "2022-05-25T10:55:16+02:00"

• updated_at (سلسلة نصية): التاريخ والوقت عندما تم تحديث المنتج آخر مرة، بتنسيق ISO-8601. مثال: "2022-05-25T10:55:16+02:00"

• published_at (سلسلة نصية): التاريخ والوقت عندما تم نشر المنتج، بتنسيق ISO-8601. مثال: "2022-05-25T10:55:16+02:00"

• vendor (سلسلة نصية): اسم بائع المنتج. مثال: "My Vendor"

• deleted_at (سلسلة نصية): التاريخ والوقت عندما تم حذف المنتج (إذا كان ذلك مناسبًا)، بتنسيق ISO-8601. مثال: "2022-05-25T10:55:16+02:00" أو سلسلة فارغة "" إذا لم يتم حذف المنتج.

الحقول الاختيارية:

• url (سلسلة نصية): عنوان URL للمنتج. مثال: "https://www.myproduct.com"

• type (سلسلة نصية): نوع المنتج، الذي يمكن استخدامه لتصفية والبحث عن المنتجات. مثال: "color"

• variants (مصفوفة): مصفوفة منVariants المنتج. إذا تم تحديدها، يجب أن تتضمن كل Variant id وname وsku والسعر.

مثال:

[
  {
    "id": "44775891271934",
    "name": "Colorful",
    "price": 13.37,
    "sku": "BIRD",
    "price_currency": "EUR"
  }
]

• images (مصفوفة): مصفوفة من صور المنتج. إذا تم تحديدها، يجب أن تتضمن كل صورة id وposition وurl وalt وwidth وheight. يمكن أن ترتبط مصفوفة variant_ids أيضًا بالصور لربطها بنسخ محددة من المنتج.

[
  {
    "id": "41083401765118",
    "position": 1,
    "url": "https://images.com/s/files/1/0640/9021/0558/files/61dJSqBcgeL._AC_SX679.jpg?v=1709712277",
    "alt": "Product Image",
    "width": 679,
    "height": 1071,
    "variant_ids": [
      44775891271934
    ]
  }
]

variant_ids (مصفوفة): مصفوفة من معرفات النسخ المرتبطة بصورة المنتج.