Skip to main content

Создать или обновить товар

Этот раздел документации описывает структуру данных для товара, получаемого через API. Структура данных включает основную информацию о товаре, его атрибутах, а также данные о наличии товара на складах и его цене.

Параметры запроса

ПараметрФорматОбязательноеОписание
pageЦелое числоНеобязательноеНомер страницы, если данные разбиты на несколько страниц.
limitЦелое числоНеобязательноеКоличество элементов на странице.
last_updated_dateДатаНеобязательноеФильтрация данных по дате последнего обновления. Если параметр last_updated_date не указан или не передан в запросе, система по умолчанию вернёт все данные без фильтрации по дате.

Пример использования параметров запроса

Для получения списка с пагинацией и фильтрацией по дате последнего обновления, запрос может выглядеть следующим образом:

GET /attributes?page=2&limit=10&last_updated_date=2024-12-01

Этот запрос вернёт вторую страницу данных, с 10 элементами, обновлёнными после 1 декабря 2024 года.

Пример ответа

[
{
"id": "Djh2f-u2n7d-2Nk82-sM2u7",
"product_card_id":"U7nKD8wYd",
"product_group_id":"LD1h4sJ72",
"name_ru": "Мужские кроссовки Skechers GO walk Max Walker - Titus 216581",
"name_uz": "Erkaklar krossovkalari Skechers GO walk Max Walker - Titus 216581",
"description_ru": "Наслаждайтесь максимальным комфортом и спортивным стилем в Skechers GO WALK Max Walker- Titus. Эта конструкция для ходьбы со шнуровкой на банджи имеет спортивный верх из сетки со стелькой Skechers Goga Mat с воздушным охлаждением, легкой амортизацией ULTRA GO и межподошвой Skechers Max Cushioning — и все это на подошве Goodyear Performance Outsole.",
"description_uz": "Skechers GO WALK Max Walker-Titus-da maksimal qulaylik va sport uslubidan bahramand bo'ling. Bu bungi bogʻichli yurish dizayni havo bilan sovutilgan Skechers Goga Mat oyoq toʻshagi, engil ULTRA GO amortizatori va Skechers Max Cushioning oʻrta tagligi bilan sportga oʻxshash toʻrli ustki qismni oʻz ichiga oladi — barchasi Goodyear Performance tashqi tagligi ustida.",
"partner_sku": "216582-OLV",
"barcode": "197627702957",
"brand_name": "Skechers",
"category_id": "e81d24e9-287c-42c3-815f-f4a55adc27c2",
"weight": 100,
"dimensions": {
"length": 55,
"width": 40,
"height": 15
},
"attributes": [
{
"id": "iUy7s-Iu8wn-Khd2n-Yqn8s",
"name": "Цвет",
"value_id": "Ywu6-Pys6q-Ur15n-Uns71",
"value_name": "BLACK"
}
],
"prices": [
{
"warehouse_id": "Uh2o-Hyes-Luw7d-uY6wn",
"price": 1000000,
"discount": 0
},
{
"warehouse_id": "Yqjsp-quNs8-Slh21-Pshy5",
"price": 1000000,
"discount": 0
}
],
"updated_at": 1235674721647612,
"is_adult": false,
"psic": "197627702957",
"package_code": "197627702957",
"main_photo": "https://cdn.example.com/88b43840-a604-42bf-8d32-d5697bed1540.jpg",
"photos": [
"https://cdn.example.com/88b43840-a604-42bf-8d32-d5697bed1540.jpg",
"https://cdn.example.com/88b43840-a604-42bf-8d32-d5697bed1540.jpg"
]
}
]

Описание полей

Основные данные товара

ПараметрФорматОбязательноеОписание
idСтрокаОбязательноеУникальный идентификатор товара.
product_card_idСтрокаОбязательноеУникальный идентификатор карточки товара.
product_group_idСтрокаНеобязательноеУникальный идентификатор группы товаров.
name_ruСтрокаОбязательноеНазвание товара на русском языке.
name_uzСтрокаОбязательноеНазвание товара на узбекском языке.
description_ruСтрокаНеобязательноеОписание товара на русском языке.
description_uzСтрокаНеобязательноеОписание товара на узбекском языке.
partner_skuСтрокаОбязательноеSKU (артикул) товара у партнера.
barcodeСтрокаОбязательноеШтрихкод товара.
brand_nameСтрокаНеобязательноеБренд товара.
category_idСтрокаОбязательноеИдентификатор категории, к которой относится товар.
weightЧислоНеобязательноеВес товара в граммах.
dimensionsОбъектНеобязательноеРазмеры товара.
dimensions.lengthЧислоНеобязательноеДлина товара в миллиметрах.
dimensions.widthЧислоНеобязательноеШирина товара в миллиметрах.
dimensions.heightЧислоНеобязательноеВысота товара в миллиметрах.
attributesМассив объектовОбязательноеАтрибуты товаров.
pricesМассив объектовОбязательноеЦена товара.
is_adultБулевоОбязательноеУказывает, является ли товар для взрослых (true - только для взрослых, false - для всех).
main_photoСтрокаОбязательноеURL основного изображения товара.
photosМассив строкНеобязательноеСписок URL изображений товара.
psicСтрокаНеобязательноеИдентификатор товара по системе партнера.
package_codeСтрокаНеобязательноеКод упаковки товара.
updated_atЧислоОбязательноеВремя последнего обновления данных товара в формате Unix timestamp.

Атрибуты товаров

ПараметрФорматОбязательноеОписание
idСтрокаОбязательноеИдентификатор атрибута.
nameСтрокаОбязательноеНазвание атрибута (например, "Цвет").
value_idСтрокаОбязательноеИдентификатор значения атрибута.
value_nameСтрокаОбязательноеНазвание значения атрибута (например, "BLACK").

Информация о ценах

ПараметрФорматОбязательноеОписание
warehouse_idСтрокаОбязательноеИдентификатор склада.
priceЧислоОбязательноеЦена товара на складе.
discountЧислоОбязательноеСкидка на товар (в процентах).

Важные замечания

  • product_card_id: Определяет основную категорию товара (например, "Футболки", "Джинсы").
  • product_group_id: Создает подкатегории внутри основной категории (например, "Белая футболка", "Черная футболка").
  • id: Является уникальным идентификатором конкретного товара со всеми его характеристиками (например, "Белая футболка, размер M").