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

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

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

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

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

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

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

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

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

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

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

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

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

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

• variants (array): مصفوفة من أنواع المنتجات. إذا ذكر، يجب أن تشمل كل نوع id, name, sku، والسعر.

مثال:

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

• images (array): مصفوفة من صور المنتجات. إذا ذكر، يجب أن تشمل كل صورة 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 (array): مصفوفة من معرفات الأنواع المرتبطة بصور المنتج.