Skip to main content

API продуктов

⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃

End-point: Создание/обновление продукта#

Method: POST#

https://lk.market/api/v1/products

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Request#

[    {        #Компания в который добавить/обновить продукт.        "sellerId": int,            #string необязательный Идентификатор в источнике данных. Полезен при объединении продуктов, загруженных из разных МП, в один.        "externalId": string(var),             #string Обозначение источника данных. Например, "mysweetshop.com".        "source": string(var),                #Определяет поле по которому искать существующий продукт в LK.MARKET, доступные на данный момент значения [id].         "identityField": string(var),            #необязательный. Если указан id существующего в базе продукта, он обновится, в противном случае добавится новый.         "productId": ?int,             #object необязательный. Системные, общие для всех маркетов поля продукта. Актуальный список, описания определены в методе https://lk.market/api/v1/attribute/common.        #В формате attributeId(string): value(array|object|string|int)        "common": object,             #UUID системные категории. не обязательное        "subCategory": string,             #array необязательный. Системные, общие для всех МП характеристики продукта связанные с системной категорией.         #В формате attributeId(string): value(array|object|string|int)        "subCategoryFields": object                #array необязательный. Альтернативный способ заполнения общих для всех МП характеристик продукта связанные с системной категорией. При использовании данного способа, поле subCategory обязательно для заполнения.        #При заполнении продукта, выполняется поиск характеристики в рамках категории по ключу label на русском языке, при отсутствии - для категории добавляется новое поле и заполняется переданным значением.        "subCategoryNotMappedFields": [            {                "label": "labelName",                "value": "int|number|string|array"            }        ]    }]

Example request#

[    {        "sellerId": 2,        "subCategoryFields": [],        "externalId": "1234932",        "productId": 4040,        "identityField": "id",        "common":         {            "1c6cd94a-5b32-4947-a2a4-792f5ad18cf7": "Демо продукт",            "607383b4-decb-4301-93a9-b1b47922ff84": ["http://cdn.com/image2.jpg", "http://cdn.com/image2.jpg"]        }    }   ]

Response (raw)#

HTTP 200

{    "success": true,    "errors": [],    "data":     [{        "id": 4040    }]}

End-point: Получение продуктов#

Этот метод скоро будет удален. Пожалуйста, перейдите на обновленный метод получения продуктов

Method: GET#

https://lk.market/api/v1/products?seller={seller.id}

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Query Params#

Paramvalue
seller{seller.id}

Response#

Код: 200

{    "success": bool (Успешность ответа),    "errors": array (Ошибки),    "data": array (Результаты ответа)     [{        "id": int (Идентификатор в системе LK.MARKET),        "commonFields": array (Атрибуты продукта lk.market),        "subCategoryFields": array (Характеристики системных категорий),        "marketsFields": array (Характеристики товара по маркеплейсам)    }]}

Response example#

{    "success": true,    "errors": [],    "data":     [{        "id": 1234,        "commonFields":         [{            "label": "Название",            "name": 1,            "description": null,            "value": "Беспроводная зарядка",            "type": "string",            "isDictionary": false,            "allowTranslate": true,            "options": [],            "multiple": false,            "required": false        }],        "subCategoryFields": [],        "marketsFields":         {            "2913309466":             {                "common":                 [{                    "label": "Внешний ID",                    "name": 18,                    "description": null,                    "value": "1005003464322256_sc-2021",                    "type": "string",                    "isDictionary": false,                    "allowTranslate": false,                    "options":                     [                        "1005003464322256_sc-2021"                    ],                    "multiple": false,                    "required": false                }],                "category":                 [{                    "label": "sku_Доставка из",                    "name": 331,                    "marketCategory": 5324,                    "description": null,                    "value": null,                    "type": "dropdown",                    "isDictionary": true,                    "allowTranslate": false,                    "options": [],                    "multiple": false,                    "required": false,                    "synonym": false,                    "errors": []                }]            }        }    }]}

⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃

End-point: Получение продуктов v2#

Method: POST#

https://lk.market/api/v2/products

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Request#

{    "seller": int (ID продавца),    "ids": array (Массив с идетификаторами продуктов в формате int или string),    "limit": int (Максимальное количество результатов на страницу),    "page": int (Страница выдачи товаров),    "fields": array(int)}

Example request#

{    "seller": 1930,    "ids": [42886, 42896],    "limit": 2,    "page": 1,    "fields": ["name", "sku"]}

Response#

Код: 200

{    "success": bool (Успешность ответа),    "errors": array (Ошибки),    "data": array (Результаты ответа)     [{        "sellerId": int (Идентификатор продавца в системе LK.MARKET),        "productId": int (Идентификатор товара в системе LK.MARKET),        "externalId": string (Идентификатор товара во внешней системе),        "identityField": string (Поле по которому ),        "common": array (Характеристики товара из основной вкладки)    }]}

Response example#

{  "success": true,  "data": [    {      "sellerId": 1245,      "productId": 42886,      "externalId": "83562042",      "identityField": "id",      "common": {        "48da2e19-d3e7-405d-bfc8-50dfb83db39d": "Цепочка для очков",        "b69965e6-63ae-4c96-8692-fe9c5a69f522": "IOD8HF3K7KJJ",      }    },    {      "sellerId": 1245,      "productId": 42896,      "externalId": "83562043",      "identityField": "id",      "common": {        "48da2e19-d3e7-405d-bfc8-50dfb83db39d": "Цепочка для очков",        "b69965e6-63ae-4c96-8692-fe9c5a69f522": "043SKDLEN3LM",      }    }  ]}

⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃

End-point: Дерево категорий#

Method: GET#

https://lk.market/api/v1/category/tree

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Response (raw)#

"success": bool (Успешность ответа),"errors": array (Ошибки),"data": array (Результаты ответа) [      {        "id": string(36) (Идентификатор в системе LK.MARKET),        "name": string(var) (Наименование категории),        "children": array (Дочерние категории),        "deprecated": bool (Если true то категория более не используется в системе LK.MARKET и будет удалена из ответа данного метода в течении 30 дней после установки флага)      }    ]}

Example (raw)#

{  "success": true,  "errors": [],  "data": [    {      "id": "8ff0c694-543a-4ede-9069-646a9d7c15cc",      "name": "Автотовары",      "deprecated": false,      "children": [        {          "id": "aec9ecc5-af80-4480-bb8c-c8964a1905c6",          "name": "Минеральное масло",          "deprecated": false,          "children": []        }      ]    }  ]}

⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃

End-point: Характеристики продукта#

Method: GET#

https://lk.market/api/v1/attribute/common

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Response (raw)#

"success": bool (Успешность ответа),"errors": array (Ошибки),"data": array (Результаты ответа) [        {        "id": string(36) (Идентификатор в системе LK.MARKET),        "name": string(var) (Наименование характеристики),        "type": string(var) (Тип характеристики [string, text, integer, number, image, file]),        "description": string(var) (Описание характеристики, например “Цвет изделия указывать в палитре изготовителя”)        "isDictionary": bool (Является ли справочной характеристикой, для которой надо подгружать предопределенные значения)        "multiple": bool (Значение должно быть списком)        "required": bool (Обязательная характеристика)        }    ]}

Example (raw)#

{  "success": true,  "errors": [],  "data": [    {      "id": "0968ce32-27e5-4bdc-96f3-de52b00452dd",      "name": "Бренд",      "type": "string",      "description": null,      "isDictionary": false,      "deprecated": false,      "multiple": false,      "required": false    }  ]}

⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃

End-point: Характеристики продукта по категориям#

Method: GET#

https://lk.market/api/v1/attribute/for-category?category={category.id}

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Query Params#

Paramvalue
category{category.id}

Response (raw)#

"success": bool (Успешность ответа),"errors": array (Ошибки),"data": array (Результаты ответа) [        {        "id": string(36) (Идентификатор в системе LK.MARKET),        "name": string(var) (Наименование характеристики),        "type": string(var) (Тип характеристики [string, text, integer, number, image, file]),        "description": string(var) (Описание характеристики, например “Цвет изделия указывать в палитре изготовителя”)        "isDictionary": bool (Является ли справочной характеристикой, для которой надо подгружать предопределенные значения)        "multiple": bool (Значение должно быть списком)        "required": bool (Обязательная характеристика)        }    ]}

Example (raw)#

{  "success": true,  "errors": [],  "data": [    {      "id": "0968ce32-27e5-4bdc-96f3-de52b00452dd",      "name": "Бренд",      "type": "string",      "description": null,      "isDictionary": false,      "deprecated": false,      "multiple": false,      "required": false    }  ]}

⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃

End-point: Доступные значения для справочной характеристики#

Характеристики с isDictionary = true

Method: GET#

https://lk.market/api/v1/attribute/values?attribute={attribute.id}

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Query Params#

Paramvalue
attribute{attribute.id}

Response (raw)#

"success": bool (Успешность ответа),"errors": array (Ошибки),"data": array (Результаты ответа) [        {            "id": string(36) (Идентификатор в системе LK.MARKET),            "value": string(var) (Значение, например “Orange computers Ltd”),            "picture": string(var) (URL изображение означающее логотип, либо изображение помогающее отличить одноименные бренды, марки и т.д. )        }    ]}

Example (raw)#

{  "success": true,  "errors": [],  "data": [    {      "id":"08895b32-9f21-4e89-9242-7076fe339e0d",      "value":"Orange computers Ltd",      "picture": "https://lk.market/uploads/3434242.jpg"    },    {      "id":"c8fd65c6-be41-4510-87a7-08e15f1a99de",      "value":"SemiContuctors",      "picture": "https://lk.market/uploads/3434242.jpg"    }  ]}

⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃ ⁃

End-point: Изменение цен#

Method: POST#

https://lk.market/api/v1/offers/set

Headers#

KeyValue
Сontent-typeapplication/json
Acceptapplication/json
X-Client-Id****
X-Api-Token***

Request#

[{    "productId": int (ID продукта),    "sellerId": int (ID продавца),    "baseOffer":    {        "price": float|null (Цена),        "oldPrice": float|null (Цена до скидки),        "margin": float|null (Наценка)    },    "marketsOffers":    [{        "marketId": string (ID маркетплейса/канала),        "price": float|null (Цена),        "oldPrice": float|null (Цена до скидки),        "margin": float|null (Наценка)    }]}]

Example Request#

[{    "productId": 1093886,    "sellerId": 1937,    "baseOffer":    {        "price": 150,        "oldPrice": 170,        "margin": null    },    "marketsOffers":    [{        "marketId": "Ozon",        "price": 170,        "oldPrice": 150,        "margin": 78    }]},{    "productId": 1093885,    "sellerId": 1937,    "baseOffer":    {        "price": 150,        "oldPrice": 150,        "margin": null    },    "marketsOffers":    [{        "marketId": "Ozon",        "price": 150,        "oldPrice": 150,        "margin": 78    }]}]
Внимание!

В "marketId" нужно отправлять текстовый идентификатор: "Ozon", "Wildberries", Яндекс.Маркет, Мегамаркет, AliExpress, Avito, 1C, Bitrix CMS, Kaspi, Lamoda, PochtaRossii, Леруа Мерлен, Веб-сайт, LK.MARKET - 1, Supplier - 1, eBay, Allegro, Amazon, Asos, Berito, Carrefour, DealBy, Etsy, Farfetch, Flipkart, Fruugo, Home Depot, Joom, Mercado Libre, Pandao, Rakuten, Zalando, Taobao, Target, Walmart, .. При возникновении вопросов, пишите нам в поддержку LK.

Response (raw)#

{    "success": bool (Успешность ответа),    "errors": array (Ошибки),    "data": array (Результаты ответа) [productId int (ID продукта) ]}

Example Response (raw)#

{    "success": true,    "errors": [],    "data": [ 1093886, 1093885 ]}