getProductById

احصل على كائن منتج واحد بواسطة المعرف.

الوصف

تسترجع هذه الطريقة كائن منتج واحد بناءً على معرفه (id) من واجهة برمجة التطبيقات (API). تعيد Promise التي تحل إلى كائن للمنتج IProductsEntity.

Products.getProductById(
id*,
langCode
);

مخطط المعلمات

المخطط

id(مطلوب): رقم
معرف المنتج
مثال: 12345

langCode: سلسلة
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

أمثلة

مثال بسيط

const response = await Products.getProductById(1);

مثال مع السمات

const response = await Products.getProductById(1, 'en_US');

مثال على الاستجابة

{
  "id": 2954,
  "attributeSetIdentifier": "products",
  "localizeInfos": {
    "title": "صندوق"
  },
  "statusLocalizeInfos": {
    "title": "تخفيض"
  },
  "isVisible": true,
  "statusIdentifier": "sale",
  "position": 1,
  "templateIdentifier": null,
  "shortDescTemplateIdentifier": "product_preview",
  "price": 51,
  "additional": {
    "prices": {
      "min": 51,
      "max": 150
    }
  },
  "sku": null,
  "isSync": true,
  "categories": [
    "catalog"
  ],
  "attributeValues": {
    "product-name": {
      "type": "string",
      "value": "product-name",
      "isIcon": false,
      "position": 0,
      "additionalFields": [],
      "isProductPreview": false
    },
    "price": {
      "type": "integer",
      "value": 51,
      "isIcon": false,
      "position": 1,
      "additionalFields": [],
      "isProductPreview": false
    },
    "currency_products": {
      "type": "string",
      "value": "usd",
      "isIcon": false,
      "position": 2,
      "additionalFields": [],
      "isProductPreview": false
    },
    "img": {
      "type": "image",
      "value": {
        "size": 241636,
        "filename": "files/project/product/2954/image/7e0a6a70-a23d-410f-8b6a-f8b4f7483244.png",
        "downloadLink": "https://your-project.oneentry.cloud/cloud-static/files/project/product/2954/image/7e0a6a70-a23d-410f-8b6a-f8b4f7483244.png"
      },
      "isIcon": false,
      "position": 3,
      "additionalFields": [],
      "isProductPreview": false
    }
  },
  "productPages": [
    {
      "id": 2847,
      "pageId": 10,
      "productId": 2954,
      "positionId": 3190,
      "categoryPath": "catalog"
    }
  ],
  "blocks": [
    "product_block"
  ],
  "moduleFormConfigs": []
}

مخطط الاستجابة

المخطط: IProductsEntity

id: رقم
المعرف الفريد.
مثال: 12345

localizeInfos: ILocalizeInfo
اسم المنتجات، مع الأخذ في الاعتبار التوطين.
مثال:

statusIdentifier: سلسلة | null
معرفات حالة صفحة المنتج (قد تكون null).
مثال: "in_stock"

statusLocalizeInfos: أي
وصف JSON لكائن حالة العنصر، مع الأخذ في الاعتبار اللغة.
مثال:

attributeSetIdentifier: سلسلة | null
مجموعة معرفات السمات.
مثال: "set_12345"

position: رقم
رقم العنصر (للتصنيف).
مثال: 1

templateIdentifier: سلسلة | null
معرف المستخدم للقالب المرتبط.
مثال: "template_12345"

shortDescTemplateIdentifier: سلسلة | null
معرف المستخدم للقالب المرتبط للوصف القصير.
مثال: "short_desc_template_12345"

price: رقم
قيمة سعر صفحة المنتج المأخوذة من الفهرس.
مثال: 150

additional: كائن
قيمة إضافية من الفهرس.
مثال:

{
  "en": "متوفر في المخزون",
  "de": "متوفر"
}

sku: سلسلة | null
SKU المنتج (وحدة حفظ المخزون)، قد تكون null.
مثال: "SKU_12345"

isSync: بولياني
إشارة إلى فهرسة الصفحة.
مثال: true

attributeValues: AttributeType
مصفوفة من قيم السمات من الفهرس، ممثلة.
مثال:

[
  {
    "id": "color",
    "value": "red"
  }
]

categories: سلسلة[]
فئات المنتج.
مثال:

[
  1,
  2,
  3
]

isVisible: بولياني
علامة رؤية الصفحة.
مثال: true

productPages: أي
مصفوفة من صفحات المنتجات أو كائن صفحة منتج واحد.
مثال: []

blocks: سلسلة[]
مصفوفة من معرفات الكتل.
مثال:

[
  "block_12345",
  "block_67890"
]

isPositionLocked: بولياني
مؤشر قفل موضع التصنيف (اختياري).
مثال: false

relatedIds: رقم[]
معرفات صفحات المنتجات ذات الصلة.
مثال:

getProductById

الوصف​

مخطط المعلمات​

أمثلة​

مثال بسيط​

مثال مع السمات​

مثال على الاستجابة​

مخطط الاستجابة​