getProductsByIds

Получение нескольких продуктов по их идентификаторам

Products.getProductsByIds(ids, langCode, userQuery)

const value = await Products.getProductsByIds('1, 5, 8', 'en_US')

Схема

ids: строка
Идентификаторы страниц продуктов, для которых необходимо найти связи
пример: "12345,67890"

langCode: строка
Код языка. По умолчанию "en_US"

userQuery: IProductsQuery
Необязательные параметры запроса
пример:

{
  "offset": 0,
  "limit": 30,
  "sortOrder": "DESC",
  "sortKey": "id"
}

offset(обязательный): число
Параметр для постраничной навигации. По умолчанию: 0.

limit(обязательный): число
Параметр для постраничной навигации. По умолчанию: 30.

sortOrder(обязательный): строка
Порядок сортировки "DESC" | "ASC". По умолчанию: "DESC".

sortKey(обязательный): строка
Поле для сортировки (по умолчанию - null). Возможные значения: "id", "position", "title", "date", "price". По умолчанию: null.

templateMarker: строка
Идентификатор статуса страницы продукта, по умолчанию null.
пример: "template_12345"

statusMarker: строка
Идентификатор статуса страницы продукта, по умолчанию null.
пример: "in_stock"

conditionValue: строка
Исковое значение, по умолчанию null.
пример: "new"

attributeMarker: строка
Текстовый идентификатор индексируемого атрибута, по которому фильтруются значения, по умолчанию null.
пример: "color"

conditionMarker: строка
Идентификатор условия фильтрации, по которому фильтруются значения, по умолчанию null.
пример: "equals"

Этот метод извлекает объекты продуктов на основе их идентификаторов (ids) из API. Он возвращает Promise, который разрешается в объекты IProductsEntity для продукта.

Пример возвращаемого значения:

[
  {
    "id": 2954,
    "localizeInfos": {
      "title": "Коробка"
    },
    "statusIdentifier": "sale",
    "statusLocalizeInfos": {
      "title": "Распродажа"
    },
    "attributeSetIdentifier": "products",
    "position": 2,
    "templateIdentifier": null,
    "shortDescTemplateIdentifier": "product_preview",
    "price": 50,
    "additional": {
      "prices": {
        "min": 50,
        "max": 150
      }
    },
    "sku": null,
    "isSync": true,
    "attributeValues": {
      "product-name": {
        "type": "string",
        "value": "product-name",
        "isIcon": false,
        "position": 0,
        "additionalFields": [],
        "isProductPreview": false
      },
      "price": {
        "type": "integer",
        "value": 50,
        "isIcon": false,
        "position": 1,
        "additionalFields": [],
        "isProductPreview": false
      },
      "currency_products": {
        "type": "string",
        "value": "usd",
        "isIcon": false,
        "position": 2,
        "additionalFields": [],
        "isProductPreview": false
      },
      "img": {
        "type": "image",
        "value": [],
        "isIcon": false,
        "position": 3,
        "additionalFields": [],
        "isProductPreview": false
      }
    },
    "categories": [
      "catalog"
    ],
    "isVisible": true,
    "productPages": [
      {
        "id": 2847,
        "pageId": 10,
        "productId": 2954,
        "positionId": 3190,
        "categoryPath": "catalog"
      }
    ],
    "blocks": [
      "product_block",
      "product_block"
    ]
  },
  {
    "id": 2955,
    "localizeInfos": {
      "title": "Продукт"
    },
    "statusIdentifier": "sale",
    "statusLocalizeInfos": {
      "title": "Распродажа"
    },
    "attributeSetIdentifier": null,
    "position": 1,
    "templateIdentifier": null,
    "shortDescTemplateIdentifier": null,
    "price": null,
    "additional": {
      "prices": {
        "min": 50,
        "max": 150
      }
    },
    "sku": null,
    "isSync": false,
    "attributeValues": {},
    "categories": [
      "catalog"
    ],
    "isVisible": true,
    "productPages": [
      {
        "id": 2848,
        "pageId": 10,
        "productId": 2955,
        "positionId": 3191,
        "categoryPath": "catalog"
      }
    ],
    "blocks": [
      "product_block",
      "product_block"
    ]
  }
]

Схема

id: число
Уникальный идентификатор.
пример: 12345

attributeValues: AttributeType
Массив значений атрибутов из индекса, представленный.
пример:

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

additional: объект
Дополнительное значение из индекса.
пример:

{
  "prices": {
    "min": 100,
    "max": 200
  }
}

localizeInfos: ILocalizeInfo
Название продуктов с учетом локализации.
пример:

{
  "title": "Cosmo"
}

isVisible: булево
Признак видимости страницы.
пример: true

isPositionLocked: булево
Индикатор блокировки позиции сортировки (необязательный).
пример: false

statusIdentifier: число
Идентификаторы статусов страниц продукта (могут быть null).
пример: NaN

relatedIds: число[]
Идентификаторы связанных страниц продуктов.
пример:

[
  12345,
  67890
]

attributeSetIdentifier: строка
Идентификатор набора атрибутов.
пример: "set_12345"

isSync: булево
Индикатор индексации страницы.
пример: true

price: число
Значение цены страницы продукта, взятое из индекса.
пример: 150

templateIdentifier: строка
Идентификатор пользователя связанного шаблона.
пример: "template_12345"

shortDescTemplateIdentifier: строка
Идентификатор пользователя связанного шаблона для краткого описания.
пример: "short_desc_template_12345"

statusLocalizeInfos: любой
JSON-описание объекта статуса элемента с учетом языка.
пример:

{
  "en": "In Stock",
  "de": "Auf Lager"
}

position: число
Номер элемента (для сортировки).
пример: 1

sku: строка
SKU продукта (единица учета запасов), может быть null.
пример: "SKU_12345"

blocks: строка[]
Массив идентификаторов блоков.
пример:

[
  "block_12345",
  "block_67890"
]

productPages: любой[]
Массив страниц продуктов или объект одной страницы продукта.
пример:

[
  {
    "id": 12345,
    "title": "Продукт 1"
  },
  {
    "id": 67890,
    "title": "Продукт 2"
  }
]

---